Fehlerbehebung: TavernAPI-Fehler in SillyTavern lösen

Prüfe zuerst diese 5 Punkte

Bevor du einzelne Fehlercodes durchgehst, geh kurz diese 60-Sekunden-Checkliste im Menü API Connections (das Stecker-Symbol oben in SillyTavern) durch. Eine kleine Korrektur an dieser Stelle löst die meisten Verbindungsprobleme sofort:

1. Chat Completion Source: Stelle API auf Chat Completion und Chat Completion Source auf Custom (OpenAI-compatible).
2. Base URL: Trage unter Custom Endpoint (Base URL) exakt https://tavernapi.com/v1 ein – ohne Schrägstrich am Ende und ohne /chat/completions.
   • Web-Apps (JanitorAI): Browser-Frontends, die nach der vollständigen Proxy-URL fragen, sind die Ausnahme – gib ihnen https://tavernapi.com/v1/chat/completions.
   • Nativer Reverse Proxy in SillyTavern: Wenn du dich über die nativen Quellen von SillyTavern statt über Custom verbindest, stelle Proxy Server URL bei der Quelle Claude auf https://tavernapi.com/v1 oder bei der Quelle Google AI Studio auf https://tavernapi.com.
3. API-Key: Füge deinen vollständigen sk-tav-...-Schlüssel ohne Leerzeichen davor oder dahinter in Custom API Key ein (oder in Proxy Password bei den nativen Quellen).
4. Verbinden und Modell wählen: Klicke auf Connect und wähle im Dropdown-Menü Available Models ein Modell aus (claude-opus-5-5, claude-sonnet-5-5, gemini-4-argon, gemini-3.8-flash oder deepseek-v4-pro).
5. Kontoguthaben: Öffne die TavernAPI-Konsole und prüfe, ob dein USD-Guthaben oder dein $0.30-Startguthaben über null liegt.

Wie TavernAPI-Fehler in SillyTavern aussehen

Wenn eine Anfrage nicht abgeschlossen werden kann, antwortet TavernAPI mit einem Standard-JSON in dieser Struktur:

{"error": {"message": "...", "type": "...", "code": "..."}}

SillyTavern zeigt den Text aus "message" in einem roten Pop-up an. Falls das Pop-up zu schnell wieder verschwindet, schau in das Fenster, in dem dein SillyTavern-Server läuft (Eingabeaufforderung unter Windows, Termux auf Android) – dort wird der Fehler zusammen mit dem HTTP-Status und dem "code" ausgegeben.

Fehlercodes

Vergleiche unten den HTTP-Status und die Meldung, um zu sehen, warum die Anfrage fehlgeschlagen ist und wie du das Problem behebst.

401 Ungültiger API-Key

• Was du siehst: Meldung Invalid API key, Code invalid_api_key. Wenn gar kein Key mitgeschickt wurde (leeres Key-Feld), beginnt die Meldung mit Missing API key und der Code lautet missing_api_key.
• Woran es liegt: Das Feld für den API-Key ist leer, der sk-tav-...-Schlüssel wurde beim Kopieren abgeschnitten, hat am Anfang oder Ende ein Leerzeichen, wurde in der Konsole gelöscht oder stammt von einem anderen Dienst (wie OpenRouter oder OpenAI).
• So behebst du es: Kopiere deinen vollständigen sk-tav-...-Schlüssel erneut ins Feld und prüfe ihn auf versehentliche Leerzeichen. Falls du die vollständige Zeichenfolge nicht mehr hast, öffne den Reiter API-Keys in der Konsole und erstelle einen neuen Key (kopiere ihn sofort, da jeder Schlüssel nur ein einziges Mal angezeigt wird).
• Wird dir etwas berechnet? Nein.

402 Guthaben nicht ausreichend

• Was du siehst: Meldung Insufficient balance, Code insufficient_balance.
• Woran es liegt: Dein aktuelles Guthaben (oder Startguthaben) ist kleiner als der vorübergehend reservierte Betrag, der zum Starten der Anfrage erforderlich ist. Vor dem Weiterleiten jedes Prompts reserviert TavernAPI einen Schätzwert aus den sichtbaren Input-Tokens plus deiner vollen Max Response Length (maximale Antwortlänge, max_tokens), berechnet zum Output-Preis des Modells. Sobald die Antwort fertig ist, berechnet TavernAPI nur die tatsächlich verbrauchten Tokens und gibt den Rest der Reservierung sofort wieder frei. Wegen dieser Vorautorisierung kann 402 auch dann erscheinen, wenn du noch etwas Guthaben übrig hast – besonders wenn Max Response Length sehr hoch eingestellt ist oder du ein höherpreisiges Modell wie claude-opus-5-5 aufrufst.
• So behebst du es:
  1. Öffne AI Response Configuration (das Schieberegler-Symbol in SillyTavern) und senke Max Response Length auf einen realistischen Wert (etwa 1024 oder 2048 Tokens), damit die Vorab-Reservierung kleiner wird.
  2. Wechsle im Dropdown-Menü auf ein günstigeres Modell wie gemini-3.8-flash oder deepseek-v4-pro (siehe Modellpreise).
  3. Oder lade dein Guthaben auf in der Konsole.
• Wird dir etwas berechnet? Nein.

403 Startguthaben oder Preset nicht freigeschaltet

• Was du siehst: Eine von drei 403-Meldungen und -Codes:
  • Modelleinschränkung im Startguthaben: Meldung Model "<id>" is not available with trial credit. Add credit to unlock it., Code trial_restricted.
  • Gesperrtes Preset-Paket: Meldung "<preset pack name>" is not included in your account. See https://tavernapi.com/console/presets (oder This preset is currently unavailable), Code preset_locked.
  • Kontostatus: Meldung Account suspended, Code account_banned.
• Woran es liegt:
  • trial_restricted: Das kostenlose Startguthaben von $0.30 funktioniert nur mit gemini-4-argon und gemini-3.8-flash. Wenn du mit einem reinen Testkonto claude-opus-5-5, claude-sonnet-5-5 oder deepseek-v4-pro anfragst, wird dieser Fehler ausgelöst.
  • preset_locked: Dein aktives SillyTavern-Preset enthält [[tav:...]]-Platzhalter aus einer Preset-Stufe, die dein Konto noch nicht freigeschaltet hat.
  • account_banned: Das Konto wurde gesperrt (siehe unsere Nutzungsrichtlinie).
• So behebst du es:
  • Bei trial_restricted: Wähle gemini-4-argon oder gemini-3.8-flash im Modell-Dropdown von SillyTavern oder lade in der Konsole Guthaben auf, um alle Modelle freizuschalten.
  • Bei preset_locked: Wechsle in SillyTavern auf dein eigenes lokales Preset, schalte die gesperrten [[tav:...]]-Einträge im Prompt Manager aus oder schalte das Preset unter https://tavernapi.com/console/presets frei. Das Standard-Preset wird mit deiner ersten Aufladung freigeschaltet; das Pro-Preset wird durch einen Einmalkauf für $4.99, ein aktives Guthabenpaket für $19 oder $39 oder ab $25 Gesamtaufladung freigeschaltet (siehe wie TavernAPI-Presets funktionieren).
  • Bei account_banned: Kontaktiere den Support mit deiner Konto-E-Mail-Adresse.
• Wird dir etwas berechnet? Nein.

404 Modell nicht verfügbar

• Was du siehst: Meldung Model "<id>" is not available, Code model_not_found.
• Woran es liegt: Die Modell-ID in deiner Anfrage enthält einen Tippfehler, stammt noch von einem anderen Anbieter (zum Beispiel anthropic/claude-... von OpenRouter oder eine alte -story-Endung) oder das Modell ist vorübergehend deaktiviert.
• So behebst du es: Klicke in SillyTavern auf Connect, um das Modell-Dropdown neu zu laden, und wähle ein Modell aus der Liste. Wenn du die Modell-ID von Hand eintippst (etwa bei JanitorAI), gib exakt eine dieser fünf IDs ein:
  • claude-opus-5-5
  • claude-sonnet-5-5
  • gemini-4-argon
  • gemini-3.8-flash
  • deepseek-v4-pro
• Wird dir etwas berechnet? Nein.

404 Nicht gefunden (falsche URL)

• Was du siehst: Meldung Not found, Code not_found.
• Woran es liegt: Der URL-Pfad ist falsch. Meistens wurde /v1 doppelt eingegeben (https://tavernapi.com/v1/v1) oder /chat/completions in das Feld Custom Endpoint von SillyTavern eingefügt (SillyTavern hängt /chat/completions von selbst an). Wenn /v1 komplett fehlt (https://tavernapi.com), landet die Anfrage auf der Website statt bei der API, sodass du eine einfache 404-Seite statt dieses JSON-Fehlers erhältst; die Lösung ist dieselbe.
• So behebst du es: Ersetze den Endpoint durch die exakte URL für dein Frontend aus Prüfe zuerst diese 5 Punkte:

• Wird dir etwas berechnet? Nein.

400 Ungültige Anfrage

• Was du siehst: Eine von drei 400-Meldungen und -Codes:
  • model is required (Code model_required)
  • messages must be a non-empty array (Code messages_required)
  • Unknown preset block [[tav:...]]. Download the latest preset from https://tavernapi.com/console/presets (Code preset_block_unknown)
• Woran es liegt:
  • model_required: Vor dem Senden der Nachricht wurde kein Modell ausgewählt.
  • messages_required: Die ausgehende Anfrage enthielt keine Nachrichten im Array (zum Beispiel durch einen leeren Prompt oder ein Regex- bzw. Erweiterungs-Skript, das alle Nachrichten entfernt hat).
  • preset_block_unknown: Deine lokale Preset-Datei ist älter als die aktuelle Preset-Definition auf dem Server, oder ein [[tav:...]]-Tag wurde von Hand bearbeitet.
• So behebst du es:
  • Bei model_required: Klicke in SillyTavern auf Connect und wähle ein Modell aus dem Dropdown-Menü.
  • Bei messages_required: Stelle sicher, dass dein Chat mindestens eine Nachricht enthält, und prüfe Erweiterungen, die den Prompt verändern.
  • Bei preset_block_unknown: Lade die neueste Preset-JSON unter https://tavernapi.com/console/presets herunter und importiere sie erneut in SillyTavern.
• Wird dir etwas berechnet? Nein.

429 Zu viele Anfragen oder Upstream ausgelastet

• Was du siehst: Meldung Upstream error (429), Typ rate_limit_error, Code upstream_error.
• Woran es liegt: Entweder hast du zu viele Anfragen auf einmal geschickt (zum Beispiel mehrfach auf Neu-Generieren geklickt, während noch eine Anfrage läuft) oder der Upstream-Modellanbieter ist gerade ausgelastet. Wenn eine Upstream-Route ihre Kapazitätsgrenze erreicht, probiert TavernAPI automatisch erst andere Routen aus, bevor 429 zurückgegeben wird.
• So behebst du es: Warte ein paar Sekunden und wische weiter (Swipe) oder generiere die Antwort neu.
• Wird dir etwas berechnet? Nein – dir wird nichts berechnet, wenn keine Antwort erzeugt wurde.

5xx-Serverfehler

• Was du siehst:
  • HTTP 502: Meldung Upstream error (502), Code upstream_error
  • HTTP 503: Meldung No upstream route is configured for this model, Code no_route
  • HTTP 500: Ein preset_...-Code (zum Beispiel preset_block_error)
• Woran es liegt:
  • Upstream error (502) (upstream_error): Der Upstream-Modellanbieter hat einen Fehler gemeldet oder die Netzwerkverbindung ist während der Anfrage abgebrochen.
  • No upstream route is configured for this model (503, no_route): Das Modell ist über alle konfigurierten Upstream-Routen hinweg vorübergehend nicht verfügbar.
  • 500 preset_...-Codes (wie preset_block_error): Beim Entfalten eines geschützten Preset-Blocks ist ein serverseitiger Fehler aufgetreten.
• So behebst du es:
  • Bei 502 (upstream_error): Warte ein paar Sekunden und wische weiter oder generiere die Antwort neu.
  • Bei 503 (no_route): Wechsle im Dropdown-Menü auf ein anderes Modell, während die Route wiederhergestellt wird.
  • Bei 500 (preset_block_error): Probiere denselben Chat ohne das TavernAPI-Preset aus (oder schalte die geschützten [[tav:...]]-Einträge aus), um zu prüfen, ob die Generierung grundsätzlich funktioniert, und kontaktiere den Support mit der ungefähren Uhrzeit und der Modell-ID.
• Wird dir etwas berechnet? Wenn der Anbieter ausfällt, bevor Antworttext erzeugt wurde, wird der reservierte Betrag vollständig zurückgebucht. Bricht die Verbindung mitten in der Antwort ab, nachdem das Streaming begonnen hat, zahlst du nur für die Tokens, die tatsächlich generiert wurden.

Probleme ohne Fehlercode

Manchmal zeigt SillyTavern kein HTTP-Fehlerbanner an, aber im Chatfenster stimmt trotzdem etwas nicht.

Connect bleibt rot oder die Modellliste ist leer

Wenn das Statuslämpchen in SillyTavern nach dem Klick auf Connect rot bleibt oder das Dropdown-Menü Available Models leer bleibt:

1. Prüfe Quelle, Base URL und API-Key anhand von Prüfe zuerst diese 5 Punkte.
2. Achte darauf, dass die URL mit https:// beginnt (nicht mit http://) und weder vor https:// noch nach /v1 Leerzeichen stehen.
3. Wenn du die native Claude- oder Google-AI-Studio-Quelle von SillyTavern nutzt, vergewissere dich, dass du den Bereich Reverse Proxy aufgeklappt und deinen sk-tav-...-Schlüssel in Proxy Password eingetragen hast – nicht in das Feld für den direkten Anbieter-Key darüber. Alle Felder findest du in der Anleitung zur SillyTavern-Einrichtung.

Antworten sind leer oder brechen mitten im Satz ab

Wenn die Nachricht des Charakters mitten im Satz aufhört oder komplett leer zurückkommt:

• Max Response Length ist zu niedrig: Eine Antwort stoppt sofort, sobald sie den Wert Max Response Length (max_tokens) im Menü AI Response Configuration von SillyTavern erreicht. Hinzu kommt: Modelle, die vor dem Antworten nachdenken (Thinking), verbrauchen einen Teil dieses Token-Budgets für ihre internen Überlegungen, bevor sie die sichtbare Antwort schreiben. Wenn Max Response Length sehr niedrig eingestellt ist (etwa auf 250 oder 400), kann das Modell das gesamte Budget für das Nachdenken aufbrauchen und die sichtbare Antwort leer lassen. Erhöhe Max Response Length (zum Beispiel auf 1024–2048 Tokens) und generiere die Antwort neu.
• Sicherheitsfilter der Upstream-Anbieter: Auch die eigenen Sicherheitsfilter des Modellanbieters können eine Antwort vorzeitig beenden oder eine leere Nachricht zurückgeben, wenn ein Prompt deren Klassifikator auslöst.

Antworten ignorieren das Preset oder zeigen [[tav:...]]-Text

Geschützte Preset-Platzhalter ([[tav:...]]) werden nur entfaltet, wenn deine Anfrage über den Server von TavernAPI läuft. Wenn deine Antworten die Preset-Regeln ignorieren oder du rohe [[tav:...]]-Zeichenfolgen im Text siehst:

1. Öffne API Connections (das Stecker-Symbol) und überprüfe, ob deine aktive Verbindung auf https://tavernapi.com/v1 zeigt – und nicht auf einen anderen Anbieter, bei dem du das TavernAPI-Preset vielleicht noch aktiviert gelassen hast.
2. Öffne AI Response Configuration (das Schieberegler-Symbol) und prüfe, ob im Dropdown-Menü Chat Completion Presets das TavernAPI-Preset ausgewählt ist und die zentralen Prompt-Einträge eingeschaltet sind.
3. Lade nach Preset-Updates die Preset-JSON unter https://tavernapi.com/console/presets neu herunter und importiere sie erneut, damit deine lokale Datei mit dem Server übereinstimmt. Siehe dazu wie TavernAPI-Presets funktionieren.

Die Kosten sind höher als erwartet

Beim Rollenspiel sendet SillyTavern deinen Chatverlauf, die Charakterkarte und das Preset bei jeder Runde erneut mit. TavernAPI senkt diese Input-Kosten automatisch durch serverseitiges Prompt-Caching. Eine ungewohnt hohe Abrechnung kommt daher fast immer durch Prompt-Cache-Misses oder einen sehr langen Chat zustande:

• Erste Nachricht nach einer Pause: Die Upstream-Anbieter halten gecachte Präfixe bei Inaktivität nur wenige Minuten im Speicher. Die erste Runde nach einer längeren Pause muss den Cache neu aufbauen und kostet daher spürbar mehr; direkt in den Runden danach sinkt der Preis wieder auf den vergünstigten Cache-Read-Tarif.
• Frühe Nachrichten bearbeiten oder Einträge am Prompt-Anfang verschieben: Wenn du eine ältere Nachricht bearbeitest oder löschst, mitten im Chat das Preset wechselst oder Zufallsmakros ({{random}}, {{roll}}) weit oben im Prompt einbaust, ändert sich der Präfix und erzwingt ein neues Schreiben in den Cache.
• Langer, ungekürzter Kontext: Ein Chat, der über 100k Tokens hinausgewachsen ist, kostet pro Runde auch mit aktivem Caching mehr als ein Chat mit 20k Tokens.

Lies unsere Anleitung zum Prompt-Caching für Tipps zu einer hohen Cache-Trefferrate und prüfe die Seite Nutzung in der Konsole, um deine genauen Input-, gecachten und Output-Tokens pro Anfrage zu sehen.

Probleme beim Aufladen und Bezahlen

Krypto-Aufladungen bei TavernAPI laufen über einen Checkout von NOWPayments in glatten Dollar-Beträgen von $6 bis $500 (siehe wie man mit Krypto bezahlt). In der Konsole zeigt jede Krypto-Bestellung unter Abrechnung einen von fünf Statuswerten an: Ausstehend (Pending), Teilweise bezahlt (Partially paid), Bezahlt (Paid), Abgelaufen (Expired) oder Fehlgeschlagen (Failed).

Es ist weniger angekommen als auf der Rechnung

Das passiert meistens dann, wenn deine Börse oder Wallet ihre Auszahlungsgebühr direkt vom gesendeten Betrag abzieht, statt die Gebühr oben draufzurechnen.

• Der Bestellstatus wechselt auf Teilweise bezahlt (Partially paid), und wir schreiben den Teil, der tatsächlich angekommen ist, automatisch anteilig deinem Guthaben gut.
• Um den fehlenden Restbetrag aufzufüllen, starte einfach eine neue Aufladung in der Konsole.
• Sende keine zweite Zahlung an die alte Einzahlungsadresse, sofern dich der Support nicht ausdrücklich darum bittet.

Die Bestellung steht auf Abgelaufen

Unbezahlte Krypto-Bestellungen schließen sich nach 1 Stunde automatisch und wechseln auf Abgelaufen (Expired). Falls deine Zahlung bereits abgeschickt wurde und erst nach Ablauf dieses 1-Stunden-Fensters auf der Blockchain eintrifft, wird sie deinem Guthaben trotzdem automatisch gutgeschrieben.

Meine Aufladung ist noch nicht angekommen

Bestätigungen im Blockchain-Netzwerk dauern normalerweise nur ein paar Minuten; bei stark ausgelasteten Netzwerken oder langsamer Sammelauszahlung durch die Börse kann es jedoch länger dauern. Dein Status unter Abrechnung in der Konsole aktualisiert sich von selbst, sobald die Transaktion bestätigt ist.

Falls sich nach etwa 30 Minuten noch nichts geändert hat, kontaktiere den Support mit:

• Dem Transaktions-Hash (TXID)
• Dem genutzten Coin und Netzwerk
• Dem gesendeten Betrag
• Deiner TavernAPI-Konto-E-Mail-Adresse

Ich habe mehr als den Rechnungsbetrag gesendet

Wenn eine Zahlung über dem Rechnungsbetrag liegt, wird automatisch nur der in Rechnung gestellte Bestellbetrag gutgeschrieben; der Mehrbetrag wird nicht von selbst hinzugefügt. Kontaktiere den Support mit deinem Transaktions-Hash (TXID) und deiner Konto-E-Mail-Adresse, damit wir die Zahlung prüfen und den Differenzbetrag deinem Guthaben gutschreiben können.

Ich habe das falsche Netzwerk oder den falschen Coin genutzt

Wenn du Guthaben über das falsche Blockchain-Netzwerk oder einen anderen Coin als beim Checkout ausgewählt gesendet hast, kontaktiere den Support bitte sofort mit dem Transaktions-Hash (TXID), dem Coin, dem Netzwerk und dem Betrag. Eine Wiederherstellung ist nicht in jedem Fall möglich.

Immer noch nicht gelöst?

Wenn die Schritte oben das Problem nicht gelöst haben, schreib uns über die Kontaktseite und gib diese Details an, damit wir sofort in den Logs nachsehen können:

• Bei API- oder Preset-Fehlern: deine TavernAPI-Konto-E-Mail-Adresse, die Modell-ID (claude-opus-5-5, claude-sonnet-5-5, gemini-4-argon, gemini-3.8-flash oder deepseek-v4-pro), wann der Fehler ungefähr aufgetreten ist (mit deiner Zeitzone), den HTTP-Status und den Fehler-code sowie den Namen des Preset-Pakets, falls du eines genutzt hast.
• Bei Zahlungsproblemen: deine Konto-E-Mail-Adresse, den Transaktions-Hash (TXID), den Coin samt Netzwerk und den gesendeten Betrag.