SillyTavern API-Integrationsanleitung: Verbinden Sie GPTProto und starten Sie das Rollenspiel

Schritt 1: SillyTavern installieren und starten

SillyTavern führt die Chat-Oberfläche, Charakterkarten und Prompt-Einstellungen auf Ihrem Computer aus. Ein verbundenes Modell generiert die Antworten. Die offizielle Projektdokumentation beschreibt es als kostenloses Open-Source-Frontend.

Halten Sie Node.js LTS, Git, ein GPT Proto-Konto mit verfügbarem API-Guthaben und eine Modell-ID bereit. Cloud-Inferenz über GPT Proto erfordert weder das Herunterladen von Modellgewichten noch das Ausführen eines Modells auf Ihrer GPU.

Installation unter macOS

Laden Sie die LTS-Version von der Node.js-Downloadseite herunter, wählen Sie macOS aus und verwenden Sie den Installer, wenn Sie eine grafische Installation bevorzugen.

Wählen Sie die aktuelle LTS-Version für Ihr Betriebssystem.

Öffnen Sie das Terminal und überprüfen Sie Git:

git --version

Installieren Sie bei Bedarf Git und führen Sie dann Folgendes aus:

cd ~
git clone https://github.com/SillyTavern/SillyTavern -b release
cd SillyTavern
bash start.sh

Beim ersten Start werden die Abhängigkeiten installiert. Lassen Sie das Terminal während der Nutzung von SillyTavern geöffnet und öffnen Sie die dort angezeigte lokale Adresse, falls sich der Browser nicht automatisch öffnet. Diese Befehle folgen den offiziellen macOS-Installationsanweisungen.

Beim ersten Start werden die erforderlichen Abhängigkeiten heruntergeladen.

So starten Sie es später erneut:

cd ~/SillyTavern
bash start.sh

Installation unter Windows

Installieren Sie Node.js LTS und Git for Windows. Erstellen Sie einen Ordner wie C:\AI, öffnen Sie diesen im Datei-Explorer, geben Sie cmd in die Adressleiste ein und drücken Sie die Eingabetaste. Führen Sie Folgendes aus:

git clone https://github.com/SillyTavern/SillyTavern -b release

Öffnen Sie den heruntergeladenen SillyTavern-Ordner und führen Sie einen Doppelklick auf Start.bat aus. Lassen Sie die Konsole während des Chattens geöffnet. Die offizielle Windows-Anleitung empfiehlt, von Windows verwaltete Ordner wie „Programme“ zu vermeiden und die Startdatei ohne Administratorrechte auszuführen.

Schritt 2: Verbinden Sie SillyTavern mit GPT Proto

Melden Sie sich bei GPT Proto an und öffnen Sie die GLM-5.3-Modellseite. Der Abschnitt „API Usage“ enthält die Modellkennung und eine Option zum Erstellen eines API-Schlüssels. Erstellen oder wählen Sie Ihren Schlüssel, überprüfen Sie den aktuellen Tarif und stellen Sie sicher, dass genügend Guthaben für einen kleinen Test vorhanden ist.

Öffnen Sie in SillyTavern die API-Verbindungen über das Stecker-Symbol in der oberen Leiste. Geben Sie Folgendes ein:

Fügen Sie den Schlüssel selbst in das Schlüsselfeld ein. Fügen Sie dort kein Bearer, keine Anführungszeichen und keinen vollständigen HTTP-Header hinzu.

Die offiziellen Anweisungen für benutzerdefinierte Endpunkte geben eine Basis-URL ohne /chat/completions an; SillyTavern fügt dieses Suffix hinzu. Für diese Verbindung sollte das Endpunktfeld bei /v1 enden.

Falls Sie zuvor unserer Janitor AI API-Einrichtungsanleitung gefolgt sind, beachten Sie diesen Unterschied: Die Proxy-URL von Janitor verwendet die vollständige https://gptproto.com/v1/chat/completions-Adresse. Das Kopieren dieser vollständigen Adresse in das Basis-URL-Feld von SillyTavern würde zu einer falschen Eingabe führen.

Stimmen Sie die Quelle, die Basis-URL, den Schlüssel und die Modell-ID mit den oben genannten Feldern ab.

Klicken Sie auf Connect und dann auf Test Message. Sie können auch vom Begrüßungsbildschirm aus ein Hello senden. Die Anleitung erzeugte die unten gezeigte Antwort.

Eine einfache Nachricht bestätigt, dass die Verbindung eine Antwort generieren kann.

Eine leere Liste der verfügbaren Modelle bedeutet nicht unbedingt, dass die Generierung nicht verfügbar ist. Geben Sie die genaue ID manuell ein, wenn die Modellerkennung nicht verfügbar ist. Um später zu anderen Modellen zu wechseln, verwenden Sie eine andere unterstützte GPT Proto-Textmodell-ID und testen Sie erneut; Modellfunktionen und akzeptierte Parameter können variieren.

Schritt 3: Importieren Sie eine Charakterkarte oder erstellen Sie Ihre eigene

Eine funktionierende API-Verbindung stellt das Modell bereit. Die Charakterkarte liefert die Identität, die Stimme und die Ausgangssituation.

Importieren Sie eine vorhandene Charakterkarte

Öffnen Sie Characters → Import Character, wählen Sie die heruntergeladene Kartendatei aus und wählen Sie den importierten Charakter aus, um mit dem Chatten zu beginnen. Sie können Charaktere auch über Extensions → Download Extensions & Assets durchsuchen.

Laden Sie für PNG-Karten die Originaldatei herunter. Ein normales Porträt oder ein Screenshot enthält keine verwendbare Charakterdefinition, es sei denn, diese Daten wurden in das Bild eingebettet. Die offiziellen FAQ erklären ungültige PNG-Importe, einschließlich Fällen, in denen das Speichern oder Bearbeiten eines Bildes dessen eingebettete Daten entfernt.

Erstelle Noah Bennett aus Text

Wähle Neuen Charakter erstellen. Beginne mit Name, Beschreibung und Erster Nachricht; fortgeschrittene Felder kannst du später hinzufügen. Die Beschreibung erklärt dem Modell den Charakter. Die erste Nachricht legt die Eröffnungsszene fest und demonstriert den gewünschten Stil. Der Leitfaden für Charakterdesign erklärt beide Felder.

Verwende den Charakter-Editor für die Identität und die Eröffnungsszene der KI.

Setze Name auf Noah Bennett. Füge dieses Originalbeispiel in die Beschreibung ein. {{char}} bezieht sich auf den Charakter und {{user}} auf deine gewählte Benutzeridentität.

Du spielst die Rolle von {{char}}, Noah Bennett, einem 25-jährigen Mann mit muskulöser Statur, einem leichten Lächeln und einer warmen, liebevollen Persönlichkeit.

ERSCHEINUNGSBILD
Noah ist 188 cm groß, hat breite Schultern, kräftige Arme, eine definierte Brust und starke Beine, die er durch jahrelanges Krafttraining aufgebaut hat. Er hat leicht zerzaustes dunkelbraunes Haar, warme haselnussbraune Augen, einen leichten Bartschatten und ein Grübchen, das erscheint, wenn er grinst. Seine übliche Kleidung besteht aus eng anliegenden T-Shirts, bequemen Joggern und Turnschuhen. Seine Stimme ist tief und warm, und er lacht leicht.

PERSÖNLICHKEIT
Noah ist ein Schatz mit verspieltem Selbstvertrauen. Er ist aufmerksam, körperlich ausdrucksstark und zeigt gerne Zuneigung. Er genießt es, {{user}} durch sanftes Necken, aufmerksame Gesten und aufrichtige Komplimente zum Lächeln zu bringen. Sein Reiz liegt in der Kombination aus seinem imposanten Körperbau und seinem überraschend weichen Herzen.

Er hat seine eigenen Meinungen, Freundschaften, Ambitionen und gelegentlich schlechte Tage. Manchmal versteckt er Nervosität hinter einem Witz und wird auf bezaubernde Weise verlegen, wenn {{user}} ihn dabei ertappt, wie er sentimental wird. Er kann Fehler zugeben und über sich selbst lachen.

HINTERGRUND
Noah arbeitet als Krafttrainer und hofft, ein kleines Fitnessstudio in der Nachbarschaft zu eröffnen. Außerhalb der Arbeit kocht er gerne, geht wandern, schaut schreckliche romantische Komödien und experimentiert mit Pfannkuchenrezepten. Er nimmt das Training ernst, verurteilt aber niemanden für seinen Körper oder sein Fitnesslevel.

BEZIEHUNG ZU {{user}}
Noah und {{user}} sind freundliche Nachbarn, die in letzter Zeit mehr Zeit miteinander verbringen. Er fühlt sich zu {{user}} hingezogen und macht sein Interesse durch Aufmerksamkeit, verspieltes Flirten und Einladungen zu alltäglichen Unternehmungen deutlich. Lass ihre Nähe durch tatsächliche Interaktionen wachsen.

FLIRTSTIL
Sein Flirtstil ist warm, spezifisch und leicht frech. Er hält vielleicht den Blick etwas länger, erinnert sich an ein Lieblingsgetränk oder gibt zu, dass er einen Vorwand gesucht hat, um vorbeizukommen. Er achtet auf die Reaktionen von {{user}} und passt sich natürlich an. Zuneigung sollte sich willkommen und gegenseitig anfühlen.

ROLLENSPIELSTIL
Bleib während der Geschichte in Noahs Charakter. Verwende natürliche Dialoge, kleine körperliche Gesten und konkrete Details anstelle von langen Persönlichkeitserklärungen.
Schreibe Aktionen in *Sternchen* und Dialoge in Anführungszeichen.
Antworte normalerweise in ein bis drei kurzen Absätzen und lass Raum für {{user}}, um teilzunehmen.
Steuere nur Noahs Sprache, Aktionen und Gedanken. Überlasse {{user}}s Dialoge, Entscheidungen und Gefühle dem Benutzer.
Behalte etablierte Details bei und reagiere direkt auf das, was gerade passiert ist.
Verwende natürliches Englisch, es sei denn, {{user}} fordert eine andere Sprache an.

Füge dies in die Erste Nachricht ein:

*Noah steht vor deiner Tür mit einer Sporttasche über einer breiten Schulter und einer kleinen Papiertüte in der Hand. Sein dunkles Haar ist noch leicht feucht und sein eng anliegendes graues T-Shirt hat einen kleinen Hauch von Mehl am Saum.*

"Bevor du etwas sagst – ja, ich kann Dinge kochen, die nicht Hühnchen mit Reis sind."

*Er hebt die Papiertüte, wobei ein Grübchen erscheint, als er lächelt.*

„Zimtschnecken. Ich habe zu viele gemacht.“ *Eine kurze Pause.* „Okay, ich habe extra welche gemacht, weil ich gehofft habe, dich zu sehen.“

„Also… hast du Zeit für einen Kaffee?“

Schließe die Charaktererstellung ab und wähle dann Noah aus. Behalte die Kernanweisungen in der Beschreibung und den Einstieg in der ersten Nachricht bei. Die Anmerkungen des Erstellers enthalten Metadaten für Personen, die die Karte lesen, und werden nicht verwendet, um den Modell-Prompt zu erstellen.

Die fertige Noah-Karte trennt seine fortlaufende Identität von seiner Begrüßung.

Legen Sie Ihre eigene Persona fest

Charaktere definieren die Identität der KI. Personas definieren Ihre. Öffnen Sie die Persona-Verwaltung, erstellen und wählen Sie eine Persona aus und fügen Sie optional einen Namen, einen Avatar und eine Beschreibung hinzu, indem Sie den offiziellen Persona-Anweisungen folgen.

Für diese fiktive Szene reicht eine kurze Beschreibung aus:

{{user}} ist ein Erwachsener, der kürzlich in die Nachbarschaft gezogen ist. Noah und {{user}} sind freundliche Nachbarn, die sich gerade kennenlernen. {{user}} entscheidet selbst über Sprache, Handlungen, Entscheidungen und Gefühle.

Verwenden Sie fiktive Details, von denen der Charakter wissen soll; Sie müssen nicht Ihre echte Biografie eingeben. Weitere Ideen zum Schreiben von Charakteren finden Sie unter wie Sie Ihren eigenen KI-Charakter mit einer API erstellen.

Schritt 4: Starten Sie Ihr erstes Rollenspiel-Gespräch

Öffnen Sie Noahs Chat und lesen Sie die Begrüßung. Im Screenshot antwortet der Benutzer mit ja, und Noah antwortet: „Ja? Okay. Großartig.“ Er setzt dann die Einladung zum Kaffee mit Handlungen und Dialogen fort. Diese generierte Fortsetzung ist der nützliche Verbindungstest.

Für einen spezifischeren Prompt, den Sie selbst ausprobieren können, senden Sie:

„Waren die Zimtschnecken also nur eine Ausrede, um mich zu sehen?“
*Ich werfe einen Blick auf die Papiertüte und dann zurück zu ihm.*

Überprüfen Sie, ob die Antwort Noahs Persönlichkeit entspricht, auf Ihre letzte Eingabe reagiert und Ihre Entscheidungen Ihnen überlässt. Wenn der Stil verbessert werden muss, bearbeiten Sie einen Teil der Karte und versuchen Sie einen neuen Chat. Vermeiden Sie es, das Modell, den Charakter-Prompt und mehrere Einstellungen gleichzeitig zu ändern; Sie werden weniger Informationen darüber haben, was geholfen hat.

Optional: Fügen Sie Ihrem Charakter Weltinformationen hinzu

Weltinformationen, auch Lorebook genannt, fügen dem Prompt unter konfigurierten Bedingungen Informationen zur Umgebung hinzu. Fügen Sie für ein erstes Experiment einen Ort aus Noahs Szene hinzu.

Öffnen Sie Weltinformationen, erstellen Sie ein Lorebook und fügen Sie einen aktivierten Eintrag unter Verwendung der schlüsselwortbasierten Strategie hinzu. Verwenden Sie diese Beispielwerte:

Verwenden Sie in Noahs Charakter-Panel Mehr… → Weltinformationen verknüpfen oder die Weltkugel-Schaltfläche für Charakter-Lore, um das Lorebook mit ihm zu verknüpfen. Fragen Sie dann: Wie ist das Corner Cafe?

Die Dokumentation zu Weltinformationen erklärt, dass der Inhalt des Eintrags in den Prompt eingeht; der Titel allein liefert nicht die Fakten. Die Aktivierung hängt auch von den Einstellungen und dem verfügbaren Budget ab, und das Modell verwendet möglicherweise nicht jedes bereitgestellte Detail. Beginnen Sie mit einem prägnanten Eintrag und überprüfen Sie dessen Verhalten, bevor Sie eine große Welt hinzufügen.

Wie viel kostet SillyTavern mit GPT Proto?

GLM-5.3 ist das für diese Anleitung verwendete Modell. Wählen Sie Ihr Modell basierend auf Budget, Natürlichkeit des Dialogs, emotionalem Ausdruck, Charakterkonsistenz und Antwortgeschwindigkeit. Vergleichen Sie Kandidaten mit derselben Karte und Eröffnungsszene. Berücksichtigen Sie bei täglichen Chats die Kosten für den beibehaltenen Kontext in Ihrem Budget; prüfen Sie bei storybasierten Szenen, ob die Stimme glaubwürdig wirkt und das Modell Ihnen die Wahl lässt.

SillyTavern selbst ist kostenlos. Die Modellgenerierung von GPT Proto nutzt Ihr API-Guthaben. Zum Zeitpunkt dieser Anleitung liegt GLM-5.3 auf GPT Proto 15 % unter den offiziellen Eingabe- und Ausgabepreisen:

Preise geprüft am 3. November 2026. Siehe das GLM-5.3 Preis-Panel für aktuelle Preise und eventuell anfallende Cache-Preise.

Eine beispielhafte Anfrage mit 8.000 nicht zwischengespeicherten Eingabe-Token und 500 abrechenbaren Ausgabe-Token kostet:

(8.000 ÷ 1.000.000 × $1,19) + (500 ÷ 1.000.000 × $3,74)
= $0,01139

Dies ist ein Berechnungsbeispiel, nicht die tatsächliche Abrechnung für die Konversation im Screenshot. Die abrechenbare Ausgabe entspricht nicht der Wortanzahl; verwenden Sie die vom Anbieter gemeldete Nutzung, einschließlich aller als Ausgabe abgerechneten Reasoning-Token.

Die Eingabe kann Charakteranweisungen, Persona, ausgewähltes Lore und den beibehaltenen Konversationsverlauf umfassen. Wie in der API-Verbindungsübersicht erklärt, setzt SillyTavern diese in den Prompt zusammen. Ein längerer beibehaltener Kontext kann die Kosten einer Antwort erhöhen, selbst wenn Ihre neueste Nachricht nur ja lautet.

Warum GPT Proto für Ihre SillyTavern-API wählen?

GPT Proto bietet offizielle Anbietermodelle mit Rabatten auf ausgewählte Modelle, einschließlich GLM-5.3. Ein Schlüssel und ein gemeinsames Guthaben decken mehrere Anbieter ab. Behalten Sie in SillyTavern Ihre Charakterkarten und die benutzerdefinierte Verbindung bei, wechseln Sie zu einer anderen unterstützten Chat-Modell-ID und vergleichen Sie deren Antworten.

Für die Zuverlässigkeit nutzen wichtige Modelle redundante Upstream-Kanäle und automatisches Failover, um Unterbrechungen zu reduzieren, wenn ein Kanal nicht verfügbar ist. Sie können zwischen Modellen mit unterschiedlichen Preisen und Konversationsstilen wählen, während Sie Ihr Setup beibehalten.

Überprüfen Sie vor einer langen Sitzung die Modellverfügbarkeit, Eingabe-/Ausgabekosten, Antwortgeschwindigkeit und Datenverarbeitung. Beginnen Sie mit einem kleinen Test und überprüfen Sie die Nutzung. Die SillyTavern-Modellseite ermöglicht es Ihnen, Optionen zu erkunden und Kosten zu vergleichen.

Häufige Probleme mit der SillyTavern-API und deren Behebung

Beginnen Sie mit einem neuen Chat und einer kurzen Nachricht. Ordnen Sie dann das Symptom der entsprechenden Prüfung zu:

Reasoning-Modelle erfordern besondere Aufmerksamkeit. Der offizielle Reasoning-Leitfaden erklärt, dass das Denken Antwort-Token verbrauchen kann, selbst wenn es verborgen ist. Ein für das Modell zu kleines Limit kann zu einer leeren oder unvollständigen sichtbaren Antwort führen. Überprüfen Sie die maximale Antwortlänge anhand der Anforderungen des Modells, anstatt für jedes Modell dasselbe kleine Limit anzuwenden.

Eine Community-Diskussion über Lorebooks und leere Antworten beschreibt einen Benutzer, der das Problem nach dem Entfernen eines Presets und der Erhöhung des Antwortlimits beheben konnte. Da beides gleichzeitig geändert wurde, lässt sich die Ursache nicht eindeutig isolieren. Dies unterstützt eine praktische Vorgehensweise bei der Fehlerbehebung: Sorgen Sie dafür, dass ein einfacher Chat funktioniert, und fügen Sie dann Presets und Lore schrittweise hinzu.

Optional: Testen der API außerhalb von SillyTavern

Wenn Ihr Schlüssel privat in der Umgebungsvariablen GPTPROTO_API_KEY gespeichert ist, sendet dieser macOS/Linux-Shell-Befehl eine direkte Anfrage unter Verwendung des Chat-Completions-Formats der Modellseite:

curl --request POST "https://gptproto.com/v1/chat/completions" \
  --header "Authorization: Bearer $GPTPROTO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "glm-5.3",
    "messages": [
      {"role": "user", "content": "Reply with: API connection works."}
    ]
  }'

Prüfen Sie auf eine erfolgreiche Antwort, die generierten Text enthält, nicht nur eine Verbindungsanzeige. Wenn dies funktioniert, während SillyTavern fehlschlägt, vergleichen Sie die Felder und hinzugefügten Parameter des Clients. Wenn beides fehlschlägt, untersuchen Sie den zurückgegebenen Authentifizierungs-, Guthaben-, Modell- oder Servicefehler. Geben Sie niemals echte Schlüssel in öffentlichen Fehlerbehebungs-Posts weiter.