DeepSeek API gebruiken in SillyTavern: aangepast endpoint

Opzetten in vijf stappen

De vraag hoe deepseek api sillytavern te gebruiken komt neer op één feit: SillyTavern kan communiceren met elk OpenAI-compatible endpoint, dus jij levert alleen een URL, een sleutel en een model-ID. Merk op dat deze service niet de officiële DeepSeek API is. Het hostt één open-weight model met de ID uncensored, gedraaid door een onafhankelijke provider en afgestemd om te antwoorden zonder inhoudsweigeringen voor legaal gebruik door volwassenen.

1. Maak een account aan en open de API-sleutelpagina. Kopieer een sleutel. Nieuwe gebruikers kunnen daar met één klik $0,50 aan proeftegoed claimen, geen kaart nodig, geldig voor 7 dagen.
2. Open in SillyTavern het tabblad API-verbindingen (het stekkerpictogram in de bovenbalk).
3. Stel het API-type in op Chat Completion. Stel dan de Chat Completion-bron in op Aangepast (OpenAI-compatible).
4. Voer in het aangepast endpoint-veld https://api.deepseekapi.top/v1 in. Plak je sleutel in het API-sleutelveld. Voer in het model-ID-veld uncensored in.
5. Druk op Connect. Een groen statuslampje en een modelnaam betekenen dat de verbinding werkt.

Labelnamen verschuiven iets tussen SillyTavern-releases, maar het idee blijft hetzelfde: Chat Completion-modus, bron Aangepast, endpoint, sleutel, model. Haal de sleutel van de API-sleutelpagina.

Als Connect mislukt

Controleer deze in volgorde. De meeste fouten zijn een van deze.

• Verkeerde URL-vorm. Het endpoint eindigt op /v1. Voeg /chat/completions niet toe.
• Verkeerde bron. De Text Completion-modus gebruikt een ander verzoekformaat. Deze API serveert POST /v1/chat/completions en GET /v1/models, dus gebruik Chat Completion.
• Sleutel geplakt met spaties. Plak hem opnieuw en controleer op een spatie aan het einde.
• Server kan geen verbinding maken met internet. Als je SillyTavern op een thuisserver of in een container draait, moet de machine uitgaande HTTPS-toegang hebben.

Om een SillyTavern-probleem van een sleutelprobleem te scheiden, test je de sleutel vanaf een terminal:

Copycurl https://api.deepseekapi.top/v1/models   -H "Authorization: Bearer YOUR_KEY" | grep uncensored

Een JSON-lijst met uncensored erin betekent dat de sleutel goed is. Om de chatroute zelf te controleren:

Copycurl https://api.deepseekapi.top/v1/chat/completions   -H "Authorization: Bearer YOUR_KEY"   -H "Content-Type: application/json"   -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Say hello in one sentence."}]}'

Instellingen die belangrijk zijn voor rollenspel

Streaming

Zet streaming aan in het Chat Completion-paneel. De API stuurt tokens via SSE zodra ze gegenereerd zijn, zodat antwoorden verschijnen terwijl ze worden geschreven. Een gestreamd verzoek houdt één van je concurrency-slots vast tot de stream eindigt. Een volledige sleutel staat 8 tegelijk toe, een proefsleutel staat 2 toe.

Contextvenstergrootte

Het model heeft een contextvenster van 100.000 tokens, inclusief prompt en completion. Je hoeft het niet volledig te gebruiken. SillyTavern stuurt de personagekaart, de persona, lorebook-regels en zoveel chatgeschiedenis als past binnen de limiet die je instelt, bij elk bericht. Een kleinere limiet betekent een lagere rekening en snellere antwoorden. Voor de meeste chats is 16k tot 32k tokens meer dan genoeg.

Maximale responslengte

Stel de responslimiet in op een verstandige waarde, zoals 400 tot 600 tokens, zodat een antwoord niet uitdraait op een essay. De API vereist max_tokens niet, maar een limiet beschermt je tegoed tegen onbeheersbaar lange antwoorden.

Sampling

Temperatuur, top_p, stop-sequentie, seed en de straffen worden doorgegeven aan het model. Een veelgebruikt startpunt voor personagechats is temperatuur 0,8 tot 1,0 en top_p rond de 0,9. Verander één waarde tegelijk. Als een personage zinnen herhaalt, verhoog dan de frequentie- of aanwezigheidsstraf iets in plaats van de temperatuur.

Stop-sequenties

Als het model ook de regels van de gebruiker begint te schrijven, voeg dan de gebruikersnaam gevolgd door een dubbele punt toe als stop-sequentie. Dit wordt doorgegeven.

Een checklist voor de eerste keer

Voordat je een favoriet personage laadt, voer een korte testchat uit zodat je weet dat de verbinding gezond is.

1. Maak een leeg personage aan of gebruik de standaard assistentkaart.
2. Stuur "Antwoord met het woord klaar." Het antwoord zou binnen een seconde of twee terug moeten komen en streamen zodra het gegenereerd is.
3. Open de SillyTavern-console of het netwerklog als er niets verschijnt. Een 401 betekent dat de sleutel verkeerd is, een 404 betekent dat de URL of model-ID verkeerd is, en een 429 betekent dat een limiet is bereikt.
4. Controleer je saldo. Elk antwoord bevat een X-Balance-USD-header, zodat je kunt verifiëren dat het tegoed per bericht met een klein bedrag daalt.
5. Laad pas dan je echte personagekaart en lorebook.

Als het antwoord leeg is of halverwege een zin wordt afgebroken, kijk dan eerst naar de responslengte-instelling. Een limiet die te laag is, beëindigt het antwoord te vroeg, en de onvolledige zin is geen modelfout.

Tussen presets wisselen

SillyTavern houdt sampling-presets gescheiden van het verbindingsprofiel. Het is de moeite waard om één preset op te slaan voor narratief schrijven, met een hogere temperatuur, en één voor korte feitelijke antwoorden, met een lagere. Het wisselen van de preset raakt het endpoint of de sleutel niet.

Wat een rollenspelsessie kost

De prijs is $0,15 per 1M inputtokens en $0,50 per 1M outputtokens, van prepaid tegoed zonder abonnement. Omdat geschiedenis opnieuw wordt verzonden, is input het grootste deel. Werk een chat door met een prompt van 20.000 tokens per bericht en een antwoord van 400 tokens:

• Input: 20.000 × $0,15 / 1.000.000 = $0,003
• Output: 400 × $0,50 / 1.000.000 = $0,0002
• Totaal: $0,0032 per bericht

Dus 100 berichten kosten $0,32. Vergelijk nu een bijgesneden context van 8.000 tokens met hetzelfde antwoord: 8.000 × $0,15 / 1.000.000 = $0,0012, plus $0,0002, wat $0,0014 per bericht en $0,14 per 100 maakt. Het verminderen van de context kost minder dan de helft voor hetzelfde aantal beurten.

Het $0,50 proeftegoed dekt ongeveer 156 berichten bij de grotere maat (0,50 / 0,0032 = 156,25) of ongeveer 357 bij de kleinere maat (0,50 / 0,0014 = 357,1). Mislukte of geweigerde verzoeken worden niet in rekening gebracht, en tegoed verloopt nooit. Zie de prijzenpagina voor opwaardeerbedragen, bonussen en betaalmethoden; kaart (Visa, Mastercard, Apple Pay, Google Pay) en crypto (USDT op TRC20, USDC op Base) worden beide geaccepteerd.

Personages, veiligheid en de ene harde regel

Het model is afgestemd op fictie, roleplay en companion-apps voor volwassenen. Het is geen algemeen veiligheidsfilter, en het beslist niet wat geschikt is voor jou. Dat is jouw taak: houd je kaarten en chats binnen legaal gebruik door volwassenen.

De enige vaste limiet is dat seksuele inhoud met minderjarigen niet is toegestaan, en geen enkele prompt verandert dat. Houd de leeftijd van personages duidelijk volwassen in je kaarten.

Enkele praktische gewoonten helpen de kwaliteit van een chat:

• Zet de kernfeiten over het personage bovenaan de kaart, niet verstopt aan het einde.
• Gebruik een korte system prompt die de stijl van de verteller en de lengte van de antwoorden vastlegt.
• Vat oude delen van de chat samen met de samenvattingsfunctie van SillyTavern in plaats van ze altijd mee te slepen.
• Houd lorebook-regels kort en activeer ze via trefwoorden, zodat ze alleen in de prompt worden opgenomen wanneer dat nodig is.

Prompts worden niet gebruikt voor training. Lees de quickstart docs voor de response headers, waaronder X-Balance-USD, dat je resterende saldo toont.

Een personage gebruiken als backend voor een companion app

Sommige mensen gebruiken SillyTavern als front end voor een langlopend companion personage voor volwassenen. Dezelfde regels gelden als voor elke chat. Houd de persona consistent door deze als een kort vast blok te schrijven, en laat de samenvattingsfunctie oudere gebeurtenissen afhandelen. Lange pauzes tussen sessies kosten niets, omdat tegoed nooit vervalt en er geen abonnement is.

Als je later je eigen app bouwt in plaats van SillyTavern te gebruiken, kun je vanuit code hetzelfde endpoint aanroepen. De quickstart docs tonen curl-, Python- en Node-voorbeelden met dezelfde base URL en model ID, zodat een prompt die in SillyTavern werkt, direct verplaatst kan worden.

Rate limits in een drukke chat

Eén enkele chat raakt de limieten zelden. Groepschats, swipes en meerdere open tabbladen wel. De service antwoordt met HTTP 429 en de code rate_limited als je de limiet voor verzoeken per minuut overschrijdt (60 op een proefsleutel, 300 op een volledige sleutel) en concurrency als er te veel verzoeken actief zijn (2 op trial, 8 op full).

Bij een korte overload krijg je ook een 429 met een Retry-After: 5 header. Vijf seconden wachten en opnieuw verzenden is de juiste reactie. Als je deze ziet op een proefsleutel, sluit dan extra tabbladen of stop een swipe voordat je een nieuwe start.

Meer handleidingen

• Hoe gebruik je de DeepSeek API in Cursor: Aangepaste Base URL-configuratie
• DeepSeek API Python-voorbeeld: chatten, streaming, tools
• DeepSeek API-sleutel: toegang tot ongecensureerde LLM API