SillyTavern

SillyTavern lässt sich auf zwei Arten mit SpicyAPI nutzen. Die erste ist die normale Chat-Verbindung: SillyTavern sendet Ihre Nachrichten über die Quelle Custom (OpenAI-compatible) an ein SpicyAPI-Chatmodell. Die zweite ist die SpicyAPI-Erweiterung. Sie ergänzt die Befehle /spicy-img und /spicy-video sowie einen Animate-Button, damit Sie Bilder und kurze Videos erzeugen können, ohne den Chat zu verlassen.

Sie können jede der beiden Möglichkeiten auch allein verwenden. Beide nutzen dasselbe Konto, dasselbe Guthaben und dieselben Preise wie der Rest von SpicyAPI, und Sie zahlen nur für das, was Sie tatsächlich ausführen. Die Erweiterung ist kostenlos und quelloffen (MIT) unter github.com/spicyapi-ai/sillytavern-spicyapi.

Bevor Sie anfangen

• SillyTavern 1.19.0 oder neuer. Die Schritte auf dieser Seite wurden am 2026-10-06 mit Version 1.19.0 geprüft. In anderen Versionen können Menübezeichnungen abweichen.
• git auf dem Rechner, auf dem SillyTavern läuft, nur wenn Sie die Erweiterung nutzen möchten. SillyTavern lädt Erweiterungen damit herunter.
• Ein API-Schlüssel. Schlüssel beginnen mit sk-spicy-. Welche Einschränkungen Sie für einen Schlüssel festlegen können, steht unter Authentifizierung. Falls Sie noch kein Konto haben, siehe Konto einrichten.
• Guthaben. Jede Anfrage wird von Ihrem vorausbezahlten US-Dollar-Guthaben abgebucht. Siehe Abrechnung.

SillyTavern-Chat mit SpicyAPI verbinden

Die Chat-Anfrage sendet der Server von SillyTavern, nicht Ihr Browser. Auf Ihrer Seite ist darüber hinaus nichts einzurichten.

Ein Chatmodell auswählen

Chatmodelle haben IDs, die auf /chat enden. Das Dropdown Available Models wird aus der vollständigen Modellliste von SpicyAPI gefüllt und zeigt deshalb auch Bild-, Video- und Audiomodelle an, die nicht chatten können. Die Chatmodelle stehen zuerst: Wählen Sie eines oben in der Liste aus, oder tippen oder fügen Sie eine /chat-ID in Enter a Model ID ein.

Alle Chatmodelle und das, was sie jeweils annehmen, finden Sie bei den Chatmodellen auf der Website. Alternativ rufen Sie GET https://api.spicyapi.ai/v1/models mit Ihrem Schlüssel auf (siehe Modelle). Jeder Chat-Eintrag enthält context_length, max_output_tokens und supported_parameters.

Für Rollenspiele bewertet das Roleplay-Leaderboard die Chatmodelle nach Figurenkonsistenz und danach, wie frei sie schreiben. Manche Chatmodelle sind unzensiert, andere filtern Inhalte. Der Katalog kennzeichnet die Richtlinienstufe jedes Modells.

Empfohlene Einstellungen

Sampling-Einstellungen, die das gewählte Modell nicht unterstützt, etwa Temperatur, Top P, Frequency Penalty und Presence Penalty, werden ignoriert statt abgelehnt. SpicyAPI listet die übersprungenen im Antwort-Header X-Spicy-Ignored-Params auf. Die Regler in SillyTavern können Sie deshalb unverändert lassen.

Reasoning-Aufwand

Das Dropdown Reasoning Effort von SillyTavern wird nicht an SpicyAPI-Modelle gesendet. Wenn Sie den Wert setzen möchten, tragen Sie ihn selbst ein, und zwar nur bei einem Modell, dessen supported_parameters den Eintrag reasoning_effort enthält:

1. Klicken Sie unter dem Connect-Button auf Additional Parameters.
2. Fügen Sie in Include Body Parameters eine Zeile hinzu, zum Beispiel:

reasoning_effort: low

Die erlaubten Werte unterscheiden sich je Modell. Eine Stufe, die das Modell nicht anbietet, wird auf die nächstliegende Stufe geändert, die es hat (im Antwort-Header X-Spicy-Adjusted-Params genannt); bei einem Modell ohne Reasoning-Stufen wird die Zeile ignoriert. Prüfen Sie zuerst den Eintrag des Modells in der Modellliste. Kommt die Antwort leer oder abgeschnitten zurück, erhöhen Sie Response (tokens) oder senken Sie den Aufwand.

Bilder im Chat

Ist Send inline media eingeschaltet, hängt SillyTavern Bilder aus dem Chat an jede weitere Anfrage an. Ein Modell, das keine Bilder lesen kann, lehnt die Anfrage mit 400 ab, und weil das Bild im Chat bleibt, scheitert jede folgende Nachricht ebenfalls. Schalten Sie Send inline media bei reinen Textmodellen aus oder blenden Sie die Nachricht mit dem Bild aus.

Videos im Chat werden nicht an das Modell gesendet.

Einstellungen, die ein Modell ablehnt

Einige Einstellungen werden weiterhin abgelehnt, wenn ein Modell sie nicht unterstützt, weil sie die Antwort verändern, statt sie nur zu feinjustieren: Multiple swipes per generation über 1 (n), Logit Bias-Presets und Request token probabilities. Schlägt eine Anfrage mit einer Meldung fehl, die eine dieser Einstellungen nennt, schalten Sie sie aus. Der Fehlertext nennt das betreffende Feld.

Custom Stopping Strings funktionieren bei jedem Modell. Ein Modell ohne Stop-Sequenzen (zum Beispiel die Grok-Modelle) ignoriert sie, und ein Modell, das weniger annimmt, als Sie gesetzt haben, behält die ersten; die Antwort-Header X-Spicy-Ignored-Params und X-Spicy-Adjusted-Params zeigen, was zutraf. Ein Reglerwert außerhalb des Bereichs eines Modells, etwa eine Temperatur von 1,5 bei einem Modell, das bei 1 endet, wird auf die gleiche Weise auf die Grenze gesenkt.

Die SpicyAPI-Erweiterung

Die Erweiterung erzeugt Bilder und kurze Videos direkt aus einem Chat heraus. Sie installieren sie einmal, tragen Ihren Schlüssel ein und wählen Modelle.

Befehle

Benannte Argumente, die Sie den Befehlen hinzufügen können:

• model=<id> verwendet ein Modell nur für diesen Lauf. Drücken Sie nach model= die Tab-Taste, um die Liste zu sehen.
• edit=true öffnet den Prompt-Editor auch dann, wenn Sie bereits einen Prompt eingegeben haben.
• quiet=true speichert das Ergebnis und gibt dessen Pfad zurück, ohne es zu posten, gedacht für Quick Replies und STscript.
• avatar=true oder avatar=false (nur bei Bildern) überschreibt die Einstellung „Avatar der Figur verwenden“.

/spicy-img a lighthouse on a cliff at dusk, wide shot
/spicy-video waves rolling onto a beach at sunrise
/spicy-video image=last slow push-in, hair moving in the wind

Das Zauberstab-Menü neben dem Chat-Eingabefeld enthält SpicyAPI picture, SpicyAPI video und SpicyAPI: animate last picture.

Animate

Jedes Bild im Chat hat unter seinen Bedienelementen ein Filmsymbol, und Nachrichten mit einem Bild haben dasselbe Symbol in ihrem ...-Menü. Es macht aus diesem Bild mit Ihrem Image-to-Video-Modell einen Videoclip und fügt den Clip derselben Nachricht hinzu.

Prompts

Geben Sie keinen Prompt an, schreibt das Chatmodell, mit dem Sie verbunden sind, einen aus der aktuellen Szene. Ist Let me read and edit the prompt before generating eingeschaltet (die Voreinstellung), öffnet sich ein Fenster mit dem Modell, dem genauen Preis und dem Prompt, so wie er geschrieben wurde. Sie können warten, einen eigenen eintippen oder erneut auf Write from the scene klicken. Die Erweiterung bringt keine Prompts, Presets oder Stile mit; die Worte kommen von Ihnen oder von Ihrem Chatmodell.

Bei Modellen, die ein Referenzbild annehmen, können Sie den Avatar der Figur verwenden, damit das Bild der Figur ähnlich sieht.

Die KI Bilder zeigen lassen

Standardmäßig ausgeschaltet. Schalten Sie im SpicyAPI-Panel Let the AI show pictures ein und wählen Sie dann, wie das Chatmodell ein Bild anfordert. Sie können eine der beiden Möglichkeiten nutzen oder beide:

Automatische Bilder haben zusätzlich zu den Limits pro Lauf (siehe unten) eigene Limits:

• höchstens ein Bild alle paar Antworten pro Chat (standardmäßig 3); auch eine abgelehnte oder fehlgeschlagene Anfrage startet die Wartezeit;
• ein Tageslimit für automatische Bilder in diesem Browser (standardmäßig $0.50);
• oberhalb Ihres Bestätigungsbetrags entweder Ask me first (Standard, zeigt die Beschreibung und den Preis an) oder Skip the picture.

Automatische Läufe erzeugen nur Bilder, nie Videos, und die Bilder bleiben für die KI verborgen wie jedes andere Ergebnis. Solange das Tool eingeschaltet ist, wird seine Definition mit jeder Chatanfrage gesendet, was auf Ihrer Chat-API einige Token kostet. Das vollständige Verhalten steht in der README der Erweiterung.

Preise und Limits

Vor jedem Lauf holt die Erweiterung bei SpicyAPI ein Angebot ein und zeigt es in US-Dollar an. Angebote sind kostenlos.

Das Panel zeigt außerdem, was in dieser Browser-Sitzung ausgegeben wurde. Für ein hartes Limit, das überall gilt, legen Sie ein Tageslimit direkt auf dem Schlüssel fest. Siehe Authentifizierung.

Ein Lauf läuft bei SpicyAPI weiter, wenn Sie auf Stop waiting klicken oder die Seite schließen, und wird bei Erfolg abgerechnet. Holen Sie ihn später mit /spicy-task <task id> ab. Fehlgeschlagene Läufe werden nicht berechnet, außer bei den wenigen Modellen, deren Seite angibt, dass abgelehnte Anfragen berechnet werden. Siehe Abrechnung.

Wo Ihr Schlüssel und Ihre Dateien gespeichert werden

• Ihr Schlüssel liegt im Klartext in der Einstellungsdatei von SillyTavern auf dem Rechner, auf dem SillyTavern läuft (data/<user>/settings.json, unter extension_settings.spicyapi). Andere SillyTavern-Erweiterungen können ihn lesen. Wenn Sie Connect chat verwenden, wird der Schlüssel zusätzlich als Schlüssel des Custom-Endpunkts in der Secrets-Datei von SillyTavern gespeichert. Deshalb lohnt sich ein eigener Schlüssel mit Ausgabenlimit.
• Ergebnisse werden heruntergeladen und im Bilderordner von SillyTavern gespeichert (data/<user>/user/images/<character>/spicyapi_<task id>.png oder .mp4) und dann an den Chat angehängt. Neue Ergebnisse sind standardmäßig vor der KI verborgen, damit die nächste Chat-Anfrage kein Bild an ein Modell sendet, das es nicht lesen kann. Schalten Sie Let the AI see generated pictures and videos ein, um das zu ändern.
• Was Ihren Rechner verlässt: Der Prompt, die Modelleinstellungen und ein eventuelles Referenzbild gehen an api.spicyapi.ai. Schreibt Ihr Chatmodell den Prompt, geht der Chat-Kontext an die Chat-API, mit der SillyTavern verbunden ist, wie bei jeder anderen Nachricht.
• SpicyAPI bewahrt erzeugte Dateien nur begrenzte Zeit auf. Siehe Aufbewahrung.

Wechseln Sie den Chat, während etwas erzeugt wird, wird das Ergebnis gespeichert, aber nicht zum Chat hinzugefügt, und die Erweiterung sagt Ihnen, wo es liegt.

Verbindungsweg

Standardmäßig spricht die Erweiterung https://api.spicyapi.ai direkt aus Ihrem Browser an. Blockiert Ihr Netzwerk oder Ihr Browser das, öffnen Sie Connection im Panel und wählen Auto (versucht es direkt, danach über den CORS-Proxy von SillyTavern) oder Through SillyTavern's CORS proxy.

Der Proxy ist standardmäßig aus. Schalten Sie ihn ein, indem Sie in der config.yaml von SillyTavern enableCorsProxy: true setzen (oder SillyTavern mit --corsProxy starten) und neu starten. Er lässt sich nicht mit der Basisauthentifizierung von SillyTavern (basicAuthMode) kombinieren, die Anfragen mit API-Schlüssel ablehnt. Nutzen Sie in diesem Fall den direkten Weg.

Fehlerbehebung

Fehler von SpicyAPI enden mit einer request_id oder einer Task-ID. Nennen Sie sie dem Support, dann lässt sich die Anfrage genau finden. Die Fehlercodes sind unter Fehler erklärt.