DeepSeek-API-Schlüssel in SillyTavern: Verbinde unsere API

Schnelle Einrichtung

Für die Einrichtung eines DeepSeek-API-Schlüssels in SillyTavern zunächst eine Klarstellung. Ein Schlüssel, der von der offiziellen DeepSeek-Plattform ausgestellt wird, gilt für den Endpunkt von DeepSeek. Der Schlüssel, den du auf dieser Seite erhältst, gehört zu einem separaten Dienst: einer unabhängigen, OpenAI-kompatiblen API, die ein Open-Weight-Modell betreibt und darauf abgestimmt ist, ohne Inhaltsablehnungen bei rechtmäßiger Erwachsenennutzung zu antworten. Dies ist nicht die offizielle API von DeepSeek, verwende den Schlüssel dieser Seite daher nur mit der Base URL dieser Seite.

Die in SillyTavern einzugebenden Werte sind:

• Quelle: Chat Completion, dann Custom (OpenAI-kompatibel)
• Custom-Endpunkt (Base URL): https://api.deepseekapikey.com/v1
• API-Schlüssel: der Schlüssel aus deinem Konto
• Modell-ID: uncensored

SillyTavern wird häufig aktualisiert, und die Bezeichnungen in den Menüs können sich zwischen den Versionen leicht ändern. Passe daher die Bedeutung an, wenn sich ein Name unterscheidet. Der Rest dieser Seite führt dich durch die einzelnen Schritte und die Einstellungen, die für lange Charakter-Chats relevant sind.

Schritt für Schritt in der Oberfläche

1. Schlüssel besorgen. Melde dich auf der API-Schlüssel-Seite mit Google oder mit E-Mail und Passwort an. Neue Nutzer können mit einem Klick $0,50 kostenloses Testguthaben beanspruchen, gültig für 7 Tage, einmal pro Person, ohne Kreditkarte.
2. API-Verbindungsoption öffnen. Klicke in SillyTavern oben auf das Steckersymbol, um API-Verbindungen zu öffnen.
3. API-Typ auswählen. Wähle im API-Dropdown Chat Completion. Die Textvervollständigungsmodi sind für Backends gedacht, die Raw Prompts entgegennehmen; diese API verwendet Chat-Nachrichten.
4. Quelle auswählen. Wähle in der Liste Chat Completion Source Custom (OpenAI-kompatibel).
5. Endpunkt eingeben. Füge https://api.deepseekapikey.com/v1 in das Feld für den Custom-Endpunkt ein. SillyTavern fügt den Pfad für Chat Completions automatisch hinzu, also lasse ihn weg. Wenn später ein 404-Fehler auftritt, versuche den vollständigen Pfad als zweiten Versuch.
6. Schlüssel eingeben. Füge den Schlüssel in das Feld für den Custom-API-Schlüssel ein.
7. Modell eingeben. Gib in das Feld für die Modell-ID uncensored ein. Wenn ein Modell-Dropdown über den GET /v1/models-Endpunkt geladen wird, kannst du es dort auswählen.
8. Verbinden. Klicke auf Verbinden. Ein grüner Status und der Modellname bedeuten, dass der Aufruf erfolgreich war. Sende eine Nachricht an einen Charakter zur Bestätigung.

Wenn die Verbindung fehlschlägt, teste außerhalb von SillyTavern in einem Terminal. Dies isoliert das Problem:

Copycurl https://api.deepseekapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Reply with the word ready."}], "max_tokens": 10}'

Eine normale JSON-Antwort bedeutet, dass Schlüssel und URL gültig sind und das Problem in den SillyTavern-Feldern liegt. Die Quickstart-Anleitung enthält weitere Beispiele.

Kontextgröße und Antwortlänge

Hier funktionieren Roleplay-Setups entweder gut oder verschwenden Geld. Das Modell verfügt über ein Kontextfenster mit 100.000 Token, das den Prompt und die Antwort zusammen zählt. SillyTavern hat in den Sampling-Einstellungen einen eigenen Schieberegler für die Kontextgröße, der steuert, wie viel Verlauf und Charakterdaten in jede Anfrage gepackt werden.

Du kannst es bis zu 100.000 einstellen, aber überlege, was das bedeutet. SillyTavern baut den vollständigen Prompt bei jedem Schritt neu auf: System-Prompt, Charakterkarte, Lorebook-Einträge, Persona und dann so viel Chat-Historie wie passt. Eine höhere Einstellung bedeutet, dass das Modell mehr von der Vergangenheit sieht, und du zahlst für jeden dieser Token bei jeder Nachricht erneut.

Eine praktische Methode zur Auswahl:

• 8.000 bis 16.000 Token: kurze Szenen und schnelle Chats. Günstig und schnell.
• 30.000 bis 50.000 Token: eine lange Geschichte mit einer detaillierten Charakterkarte und Lorebook. Gut für die meisten Nutzer.
• Bis zu 100.000 Token: große Lorebooks oder sehr lange, durchgehende Geschichten. Lasse einen Puffer, sodass Prompt plus Antwort unter dem Fenster bleiben.

Für die Antwortlänge stelle die Max Response Length auf 300 bis 600 Token für eine typische Roleplay-Antwort. Der Parameter max_tokens ist in der API optional, aber SillyTavern sendet einen Wert, und ein Limit verhindert, dass eine zu lange Antwort die Rechnung in die Höhe treibt. Aktiviere die Streaming-Option, damit Text erscheint, während er generiert wird; die API unterstützt Server-Sent Events mit stream: true.

Das Übergeben der Penalties und Sampling-Werte funktioniert wie in der Oberfläche dargestellt. Temperatur, Top P, Frequenzstrafe und Präsenzstrafe werden an das Modell gesendet, Stop-Sequenzen und ein fester Seed werden ebenfalls durchgereicht. Starte mit einer Temperatur von etwa 0,8 und passe sie an: senke sie, wenn der Charakter den Faden der Fakten verliert, erhöhe sie, wenn die Antworten sich wiederholen.

Was Roleplay kostet

Der Preis beträgt $0,15 pro 1M Input-Token und $0,50 pro 1M Output-Token. Input dominiert wegen der erneut gesendeten Historie. Durchgerechnete Beispiele mit jeweils einer Antwort von 400 Token:

Überprüfe eine Zeile: 20.000 / 1.000.000 × $0,15 = $0,003 und 400 / 1.000.000 × $0,50 = $0,0002, was $0,0032 ergibt. Bei dieser Größe deckt das Testguthaben von $0,50 etwa 156 Nachrichten ab. Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet, daher erhöhen Wiederholungen nach einem Fehler die Rechnung nicht. Swipes und Regenerierungen zählen jedoch, da jede davon eine neue abgeschlossene Anfrage ist.

Guthaben ist Prepaid-Guthaben, verfällt nie, und es gibt kein Abonnement. Lade jeden ganzen Betrag von $20 bis $500 auf, mit +5% ab $50, +10% ab $100 und +15% ab $200. Zum Beispiel: $100 Guthaben ergeben $110. Du kannst mit Krypto (USDT auf TRC20, USDC auf Base) zahlen. Die Preisseite enthält die aktuelle Liste.

Gruppenchats, Swipes und Ratenlimits

SillyTavern kann mehrere Anfragen kurz nacheinander senden: Gruppenchats, bei denen mehrere Charaktere nacheinander antworten, Swipes und Erweiterungen, die zusammenfassen oder Seitenelemente generieren. Ein vollständiger Schlüssel erlaubt 8 parallele Anfragen und 300 Anfragen pro Minute. Ein Trial-Schlüssel erlaubt 2 parallele und 60 pro Minute.

Wenn du einen Fehler mit dem Code concurrency siehst, liefen zu viele Anfragen gleichzeitig. Warte, bis der aktuelle Stream abgeschlossen ist, bevor du erneut swipst, denn eine gestreamte Anfrage belegt ihren Slot bis zum Ende des Streams. Ein Fehler mit dem Code rate_limited bedeutet, dass zu viele Anfragen pro Minute gesendet wurden. Ein 429-Fehler mit dem Header Retry-After: 5 ist eine vorübergehende Überlastung und klärt sich schnell.

Bei langen Geschichten solltest du die Zusammenfassungs-Erweiterung oder Lorebook-Einträge nutzen, um Fakten fortzuführen, damit du die Kontextgröße niedrig halten kannst. Eine kurze Zusammenfassung früherer Ereignisse am Anfang des Prompts kostet weit weniger als die Speicherung von fünfzigtausend Token Rohverlauf.

Häufige Probleme beheben

Connect sagt „unauthorized“

Der Schlüssel ist falsch, hat ein Leerzeichen am Ende oder stammt von einem anderen Dienst. Ein Schlüssel, der von der DeepSeek-Plattform ausgestellt wurde, funktioniert mit dieser Base URL nicht.

Connect sagt „not found“

Prüfe die Schreibweise des Endpunkts. Er sollte in der gängigen Konfiguration mit /v1 enden. Einige Builds erwarten den vollständigen Chat-Vervollständigungspfad; wenn die Kurzform fehlschlägt, versuche https://api.deepseekapikey.com/v1/chat/completions.

Antworten sind kurz oder abgeschnitten

Erhöhe die maximale Antwortlänge. Wenn der Abbruch nur bei langen Chats auftritt, könnte dein Prompt nahe an der Fenstergrenze liegen; reduziere die Kontextgröße etwas, damit Platz für die Antwort bleibt.

Der Charakter vergisst frühere Ereignisse

Das ist die Kontexteinstellung in Aktion. Erhöhe sie oder verschiebe wichtige Fakten in die Charakterkarte, die Persona oder einen Lorebook-Eintrag, damit sie in jedem Prompt erhalten bleiben.

Die Antwort wird abgelehnt

Das Modell ist darauf abgestimmt, Inhaltsablehnungen für die rechtmäßige Erwachsenennutzung zu vermeiden, aber eine Regel ändert sich nicht: Kein sexueller Inhalt mit Minderjährigen. Charaktere und Szenarien in diesem Bereich werden abgelehnt. Der Dienst ist nur Text, daher benötigt die Bildgenerierung in SillyTavern ein anderes Backend.

Prompts, die über die API gesendet werden, werden nicht zum Training verwendet. Deine Chat-Dateien bleiben im Datenordner von SillyTavern auf deinem Rechner, es sei denn, du verschiebst sie. Wenn du den Hintergrund wissen möchtest, wie sich dieser Dienst von DeepSeek selbst unterscheidet, sieh dir DeepSeek API: Mythen vs. Fakten an.

Weitere Anleitungen

• DeepSeek-API-Schlüssel in Janitor AI: Einrichtung mit unserer API
• DeepSeek API-Schlüssel in VS Code: Einrichtung mit unserer API
• DeepSeek API: Mythen vs. Fakten für unzensierten Zugang