SillyTavern-API-Konfiguration: OpenAI-kompatibler Verbindungsleitfaden
Wir erklären häufige Unsicherheiten bei der SillyTavern-API-Einrichtung: die Verbindung, der Key, der Modellname und die Kontextfenster-Werte, jeweils zusammen mit Bestätigungsbefehlen.
Aktualisiert am
Wichtige Punkte
- Wähle benutzerdefinierte Chat Completion (OpenAI-kompatibel).
- Die URL ist https://api.mukenetsuapi.com/v1, der Modellname ist uncensored
- Ein Kontext von bis zu 100.000 ist möglich, aber aufgrund der Kosten und Geschwindigkeit ist es realistischer, ihn zu begrenzen.
- Bei 401 den Key, bei 404 die URL und bei 429 bei der gleichzeitigen Ausführung oder dem Ratenlimit prüfen.

Bereits im Voraus 3 Dinge vorbereiten
Die SillyTavern-API-Einrichtung ist in der Durchführung kurz, die meisten Stolpersteine liegen in falschen Eingaben. Halte die folgenden 3 Dinge bereit.
- API-Schlüssel: Erstelle ihn auf der Seite zum Erhalten des API-Schlüssels. Nach der Neuregistrierung kannst du mit einem Klick $0,50 Testguthaben erhalten.
- Basis-URL:
https://api.mukenetsuapi.com/v1 - Modellname:
uncensored
SillyTavern ist ein Frontend, das das Hinzufügen eines OpenAI-kompatiblen Endpunkts ermöglicht. Da diese API OpenAI-kompatibel ist, musst du nicht den offiziellen OpenAI-Dienst wählen, sondern kannst ihn als benutzerdefinierten Endpunkt registrieren.
Verbindungsschritte
Menütexte variieren je nach Version. Hier der allgemeine Ablauf. Bei Abweichungen sieh auch in die SillyTavern-Doku.
- Öffne oben „API Connections“ (Stecker-Symbol).
- Wähle als API-Typ „Chat Completion“.
- Wähle in der Liste die OpenAI-kompatible benutzerdefinierte Verbindung (Custom).
- Gib
https://api.mukenetsuapi.com/v1als Endpunkt-URL ein. Füge/chat/completionsnicht an. - Füge den generierten Key in das API-Schlüssel-Feld ein. Achte darauf, dass keine Leerzeichen davor oder danach stehen.
- Setze den Modellnamen auf
uncensored. Wähle es aus der Liste oder gib es manuell ein. - Drücke die Verbindungstaste und prüfe die Erfolgsanzeige.
Prüfe Key und URL im Terminal, um Fehler schneller zu finden.
curl https://api.mukenetsuapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "messages": [{"role": "user", "content": "こんにちは"}], "max_tokens": 50}'Wenn eine Antwort zurückkommt, sind Schlüssel, URL und Modellname korrekt. Wenn SillyTavern dann fehlschlägt, liegt das Problem wahrscheinlich an den App-Eingaben.
Kontext und Antwortlänge festlegen
Das Kontextfenster dieser API kann bis zu 100.000 Token für Prompt und Ausgabe nutzen. Es wird jedoch nicht empfohlen, die Kontextgröße in SillyTavern auf das Maximum zu setzen, da bei jeder Anfrage Charaktereinstellungen, Lore und Verlauf neu gesendet werden. Höhere Werte erhöhen den Input pro Anfrage.
Beispielhafte Kostenberechnung
Wenn du bis zu 16.000 Token für den Kontext nutzt und die Antwort 300 Token beträgt, sieht die Kostenberechnung pro Nachricht wie folgt aus:
- Input: 16.000 ÷ 1.000.000 × $0,15 = $0,0024
- Output: 300 ÷ 1.000.000 × $0,50 = $0,00015
- Gesamt: $0,00255
100 Nachrichten kosten 0,255 $. Wenn du das Kontextfenster auf 8.000 reduzierst, halbiert sich die Eingabeseite. Details zum Preis findest du auf der Preisseite.
Richtwerte
Wenn es sich nicht um lange Geschichten oder Szenen mit vielen Charakteren handelt, ist es realistischer, zunächst mit 8.000 bis 16.000 zu starten und den Wert erst zu erhöhen, wenn du das Gefühl hast, dass Charaktere sich an vergangene Ereignisse nicht mehr erinnern. Die maximale Antwortlänge passt du an die Länge an, die du als einzelne Antwort lesen möchtest. max_tokens ist optional; wenn du zu lange Antworten vermeiden möchtest, ist es sicherer, in SillyTavern ein Limit festzulegen.
Überlegungen zu den Sampling-Einstellungen
temperature, top_p, stop, seed und verschiedene Strafkosten werden direkt an die API weitergegeben. Sie können in den SillyTavern-Voreinstellungen angepasst werden.
- Wiederholende Formulierungen: Erhöhe die Penalties für frequency und presence etwas.
- Die Antwort ist zerfahren: Senke die Temperatur.
- Die Antwort ist eintönig: Erhöhe die Temperatur etwas.
- Vergleichen: Seed fixieren, 1 Wert nach dem anderen ändern.
Die Bezeichnungen der Preset-Felder variieren je nach SillyTavern-Version. Wenn die Einstellungen nicht übernommen werden, prüfe in der SillyTavern-Dokumentation, ob deine verwendete Verbindungsmethode das jeweilige Feld unterstützt.
Häufige Fehler und Lösungen
| Symptom | Mögliche Ursache | Lösung |
|---|---|---|
| 401 | Falscher Key, Leerzeichen enthalten | Kopiere den Key erneut und teste ihn mit curl. |
| 404 | Falsche URL | Prüfe, ob die URL auf /v1 endet. |
| Modell nicht gefunden | Rechtschreibung des Modellnamens | Gib uncensored in Kleinbuchstaben ein. |
429 (concurrency) | Zu viele parallele Anfragen | Reduziere schnelles Mehrfachklicken beim Wischen oder parallele Generierungen in Gruppenchats. |
429 (rate_limited) | Pro-Minuten-Limit überschritten | Warte einen Moment. |
429 (Retry-After: 5 enthalten) | Vorübergehende Überlastung | Warte 5 Sekunden und versuche es erneut. |
Der Voll-Key erlaubt 8 parallele Anfragen und 300 pro Minute, der Test-Key 2 parallele Anfragen und 60 pro Minute. Eine Streaming-Antwort belegt bis zum Abschluss einen Slot für parallele Verbindungen. Bei Gruppenchats mit dem Test-Key ist der Slot schnell voll.
Du kannst prüfen, ob dein Guthaben ausreicht, indem du folgenden Befehl ausführst:
curl https://api.mukenetsuapi.com/v1/balance \
-H "Authorization: Bearer YOUR_API_KEY"Den Kontostand siehst du auch in den Antwortheadern unter X-Balance-USD. Die Modellliste rufst du mit GET /v1/models ab.
curl https://api.mukenetsuapi.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"Hinweise zur Nutzung
Diese API ist nur für Text ausgelegt. Für Bildgenerierung oder Audio in SillyTavern benötigst du einen anderen Dienst. Die Inhalte sind auf fiktionale Nutzung wie Romane, Rollenspiele oder Companion-Apps im Rahmen legaler Erwachsenennutzung ausgelegt. Sexuelle Inhalte mit Minderjährigen werden in jeder Konfiguration unterbunden. Prompts werden nicht zum Training des Modells verwendet.
Ausführlichere Parameter findest du in der Dokumentation. Die Bezahlung erfolgt in USDT (TRC20) oder USDC (Base) in ganzen Dollarbeträgen von $20 bis $500.
Weitere Anleitungen
Häufig gestellte Fragen
Welchen Modellnamen verwende ich in SillyTavern?
Gib uncensored ein. Schreibe es kleingeschrieben und genau so.
Muss ich /chat/completions an das URL-Ende hängen?
Nein. Die Basis-URL endet auf /v1; der restliche Pfad wird von der App automatisch ergänzt.
Reicht der Test-Key?
Für Verbindungschecks und kurze Gespräche reicht es aus. Da der Test-Key auf 2 parallele Anfragen und 60 pro Minute begrenzt ist und nur 7 Tage gültig ist, solltest du für Gruppenchats zum regulären Key aufladen.
Kann ich auch Bilder generieren?
Nein. Diese API ist ausschließlich für Text ausgelegt und unterstützt keine Bild-, Audio- oder Videogenerierung.
Wie groß sollte das Kontextfenster sein?
Das Maximum liegt bei 100.000 Tokens, aber es ist realistischer, zunächst mit 8.000 bis 16.000 zu starten. Größere Fenster erhöhen den Eingabeaufwand pro Anfrage und damit die Kosten.
API-Schlüssel über 1 Formular erhalten
Konto erstellen, Key kopieren, Basis-URL ändern – fertig.