DeepSeek API-sleutel in SillyTavern: verbind onze API

Snelle setup

Voor een deepseek api key sillytavern setup eerst een verduidelijking. Een sleutel uitgegeven door het eigen platform van DeepSeek is voor het endpoint van DeepSeek. De sleutel die je op deze site krijgt, behoort tot een aparte dienst: een onafhankelijke, OpenAI-compatible API die één open-weight model draait, afgestemd op antwoorden zonder content refusals voor legaal gebruik door volwassenen. Het is niet de officiële API van DeepSeek, dus gebruik de sleutel van deze site alleen met de base URL van deze site.

De waarden die je in SillyTavern moet invullen zijn:

• Bron: Chat Completion, dan Custom (OpenAI-compatible)
• Aangepaste endpoint (base URL): https://api.deepseekapikey.com/v1
• API-sleutel: de sleutel uit je account
• Model ID: uncensored

SillyTavern wordt vaak bijgewerkt en menu labels kunnen iets verschuiven tussen releases, dus match op betekenis als een naam verschilt. De rest van deze pagina loopt elke stap en de instellingen door die belangrijk zijn voor lange karakter chats.

Stap voor stap in de interface

1. Haal een sleutel op. Meld je aan op de API key pagina met Google of met e-mail en wachtwoord. Nieuwe gebruikers kunnen met één klik $0,50 aan trial credit claimen, geldig voor 7 dagen, één per persoon, zonder kaart.
2. Open het API-verbindingspaneel. Klik in SillyTavern op het stekkerpictogram bovenaan om API Connections te openen.
3. Selecteer het API-type. Kies Chat Completion uit de API dropdown. De text completion modi zijn bedoeld voor backends die raw prompts nemen; deze API gebruikt chat berichten.
4. Selecteer de bron. Kies in de Chat Completion Source lijst Custom (OpenAI-compatible).
5. Voer het endpoint in. Plak https://api.deepseekapikey.com/v1 in het custom endpoint veld. SillyTavern voegt het chat completions pad zelf toe, dus laat het weg. Als je later een 404 krijgt, probeer dan het volledige pad als tweede poging.
6. Voer de sleutel in. Plak de sleutel in het custom API key veld.
7. Voer het model in. Typ uncensored in het model ID veld. Als een model dropdown laadt van het GET /v1/models endpoint, kun je het daar kiezen.
8. Verbind. Druk op Connect. Een groene status en de model naam betekenen dat de call succesvol was. Stuur een bericht naar een karakter om dit te bevestigen.

Als Connect faalt, test dan buiten SillyTavern in een terminal. Dit isoleert het probleem:

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}'

Een normale JSON reply betekent dat de sleutel en URL geldig zijn en het probleem in de SillyTavern velden zit. De quickstart bevat meer voorbeelden.

Contextgrootte en responslengte

Hier werken roleplay setups goed of verspillen ze geld. Het model heeft een contextvenster van 100.000 tokens, tellend de prompt en het antwoord samen. SillyTavern heeft een eigen Context Size slider in de sampling settings, die bepaalt hoeveel van de geschiedenis en karakter data het in elk verzoek verpakt.

Je kunt het zo hoog instellen als 100.000, maar denk na over wat dat betekent. SillyTavern bouwt de volledige prompt elke beurt: system prompt, character card, lorebook entries, persona, en dan zoveel chat geschiedenis als past. Een hogere instelling betekent dat het model meer van het verleden ziet, en je betaalt voor elk van die tokens opnieuw bij elk bericht.

Een praktische manier om te kiezen:

• 8.000 tot 16.000 tokens: korte scènes en snelle chats. Goedkoop en snel.
• 30.000 tot 50.000 tokens: een lang verhaal met een gedetailleerde character card en lorebook. Goed voor de meeste gebruikers.
• Tot 100.000 tokens: grote lorebooks of zeer lange doorlopende verhalen. Laat een marge zodat de prompt plus het antwoord binnen het venster blijft.

Voor responslengte stel je Max Response Length in op 300 tot 600 tokens voor een typische roleplay reply. De max tokens parameter is optioneel in de API, maar SillyTavern stuurt een waarde, en een limiet stopt een te lange reply voordat de rekening oploopt. Schakel de streaming optie in zodat tekst verschijnt terwijl deze wordt gegenereerd; de API ondersteunt server-sent events met stream: true.

Het doorgeven van penalties en sampling waarden werkt zoals de interface suggereert. Temperature, Top P, frequency penalty en presence penalty worden naar het model gestuurd, en stop sequences en een vaste seed worden ook doorgegeven. Begin met temperature rond 0,8 en pas aan: lager als het karakter de feiten kwijt raakt, hoger als antwoorden repetitief aanvoelen.

Wat roleplay kost

De prijs is $0,15 per 1M input tokens en $0,50 per 1M output tokens. Input domineert vanwege de opnieuw verstuurde geschiedenis. Uitgewerkte voorbeelden, met een reply van 400 tokens elke keer:

Controleer één regel: 20.000 / 1.000.000 x $0,15 = $0,003, en 400 / 1.000.000 x $0,50 = $0,0002, wat $0,0032 oplevert. Bij die omvang dekt het trial tegoed van $0,50 ongeveer 156 berichten. Mislukte of geweigerde verzoeken worden niet in rekening gebracht, dus opnieuw proberen na een fout voegt niets toe aan de rekening. Swipes en regeneraties tellen wel mee, omdat elk een nieuw voltooid verzoek is.

Tegoed is prepaid, verloopt nooit, en er is geen abonnement. Laad een willekeurig bedrag op van $20 tot $500, met +5% vanaf $50, +10% vanaf $100 en +15% vanaf $200. Bijvoorbeeld, $100 wordt $110. Je kunt betalen met crypto (USDT op TRC20, USDC op Base). De prijzenpagina heeft de huidige lijst.

Groepschats, swipes en rate limits

SillyTavern kan meerdere verzoeken tegelijk sturen: groepschats waarbij meerdere personages sequentieel antwoorden, swipes en extensies die samenvatten of bijkomende inhoud genereren. Een volledige sleutel staat 8 gelijktijdige verzoeken en 300 verzoeken per minuut toe. Een proefsleutel staat 2 gelijktijdige en 60 per minuut toe.

Als je een fout ziet met code concurrency, liepen er te veel verzoeken tegelijk. Wacht tot de huidige streaming is voltooid voordat je opnieuw swipet, omdat een gestreamd verzoek zijn concurrency-slot vasthoudt tot de stream eindigt. Een fout met code rate_limited betekent te veel per minuut. Een 429 met een Retry-After: 5 header is tijdelijke overbelasting en lost snel op.

Voor lange verhalen kun je de samenvattingsextensie of lorebook-items gebruiken om feiten door te geven, zodat je de contextgrootte laag kunt houden. Een korte samenvatting van eerdere gebeurtenissen bovenaan de prompt kost veel minder dan het behouden van vijftigduizend tokens aan ruwe geschiedenis.

Veelvoorkomende problemen oplossen

Connect zegt "unauthorized"

De sleutel is onjuist, heeft een spatie aan het einde, of komt van een andere service. Een sleutel die door het DeepSeek-platform is uitgegeven, werkt niet met deze base URL.

Connect zegt "not found"

Controleer de spelling van het endpoint. Dit moet in de veelvoorkomende setup eindigen op /v1. Sommige builds verwachten het volledige pad voor chat completions, dus als de korte vorm niet werkt, probeer dan https://api.deepseekapikey.com/v1/chat/completions.

Antwoorden zijn kort of afgekapt

Verhoog de maximale responslengte. Als het afkappen alleen bij lange chats gebeurt, kan je prompt dicht bij de venstergrens zitten; verlaag de contextgrootte iets zodat er ruimte is voor het antwoord.

Het personage vergeet eerdere gebeurtenissen

Dat is het contextvenster in actie. Verhoog het, of verplaats belangrijke feiten naar de character card, persona of een lorebook-item zodat ze in elke prompt blijven.

Het antwoord wordt afgewezen

Het model is afgestemd op het vermijden van inhoudelijke afwijzingen voor legaal gebruik door volwassenen, maar één regel verandert niet: geen seksuele inhoud met minderjarigen. Personages en scenario's op dat gebied worden afgewezen. De dienst is alleen tekst, dus beeldgeneratie in SillyTavern vereist een andere backend.

Prompts die via de API worden verzonden, worden niet gebruikt voor training. Je chatbestanden blijven in de gegevensmap van SillyTavern op je machine, tenzij je ze verplaatst. Als je de achtergrond wilt weten over hoe deze dienst verschilt van die van DeepSeek, zie DeepSeek API: mythes versus feiten.

Meer handleidingen

• DeepSeek API-sleutel in Janitor AI: instellen met onze API
• DeepSeek API-sleutel in VS Code: Instellen met onze API
• DeepSeek API: Mythes vs. Feiten voor Ongecensureerde Toegang