SillyTavern API instellen: base-URL, API-key en modellijst

Kort antwoord: de vijf instellingen die ertoe doen

Open het API Connections-paneel (het stekkericoon) en stel precies dit in: API = Chat Completion. Chat Completion Source = Custom (OpenAI-compatible). Custom Endpoint (Base URL) = https://api.apisrouter.com/v1. Custom API Key = je sk-...-key. Klik op Connect, wacht op het groene lampje, en kies een model uit de lijst, bijvoorbeeld deepseek-v4-flash. De meest voorkomende fout is het plakken van het volledige pad. SillyTavern voegt zelf /chat/completions toe aan wat je invoert, dus de URL moet stoppen bij /v1. Als je https://api.apisrouter.com/v1/chat/completions plakt, vraagt SillyTavern /v1/chat/completions/chat/completions op en mislukt de verbinding met een 404. Dit is het tegenovergestelde van JanitorAI, dat juist de volledige completions-URL wil in zijn proxyconfiguratie. Dezelfde provider, andere veldconventies.

Waarom de SillyTavern API-URL eindigt op /v1

Elke OpenAI-compatibele API is een base-URL plus een set vaste routes. GET /v1/models geeft de lijst met model-ID's terug die je key mag gebruiken. POST /v1/chat/completions voert het eigenlijke chatverzoek uit. SillyTavern kent deze routes en bouwt ze zelf op, dus het vraagt je alleen om de basis. Wanneer je op Connect klikt, roept het /v1/models aan met je key en gebruikt het antwoord om de modellijst te vullen. Een lege lijst betekent bijna altijd dat die aanroep is mislukt. Je moet ook de juiste API-modus kiezen. Chat Completion stuurt gestructureerde berichten met system-, user- en assistant-rollen, wat elke gehoste OpenAI-compatibele provider verwacht. Text Completion stuurt één ruwe promptstring en bestaat vooral voor lokale backends zoals KoboldCpp en text-generation-webui. Gebruik voor elke gehoste API-key Chat Completion. Als je Text Completion selecteert tegen een gehost chat-endpoint, krijg je fouten of onleesbare opmaak, en verschillende samplers die in die modus getoond worden, worden sowieso niet verzonden.

Stap-voor-stap instellen

Blijft de lijst leeg na Connect, controleer dan achtereenvolgens drie dingen: de URL eindigt op /v1 zonder extra pad en zonder spaties erachter, de key is geplakt zonder aanhalingstekens of witruimte, en de bron is Custom (OpenAI-compatible) in plaats van gewoon OpenAI. De gewone OpenAI-bron negeert in sommige versies je aangepaste URL en praat met api.openai.com, waar je key ongeldig is.

• Haal een key op. Bij APIsRouter is er geen accountformulier: betaal op /topup en de key wordt je per e-mail toegestuurd. Elke OpenAI-compatibele key werkt op dezelfde manier in deze stappen.
• Klik in SillyTavern op het stekkericoon om API Connections te openen.
• Zet API op Chat Completion.
• Zet Chat Completion Source op Custom (OpenAI-compatible).
• Voer bij Custom Endpoint (Base URL) https://api.apisrouter.com/v1 in, zonder iets na /v1.
• Plak je key in het Custom API Key-veld.
• Klik op Connect. Het statuslampje wordt groen en de Available Models-lijst vult zich vanuit /v1/models.
• Selecteer een model, open een character card en stuur een korte testboodschap.

Verifieer de verbinding buiten SillyTavern

Test het endpoint direct als iets mislukt, voordat je SillyTavern de schuld geeft. Deze curl-aanroep is precies wat de Connect-knop doet. Krijg je een JSON-array met model-ID's terug, dan zijn je key en URL in orde en zit het probleem in de SillyTavern-velden. Werkt de modellijst wel maar mislukken chats, voer dan één echte completion uit vanuit Python met dezelfde base-URL. Een geslaagd antwoord hier bewijst de hele keten, en elke foutmelding die je terugkrijgt is de echte fout van de provider in plaats van de generieke van SillyTavern.

curl https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer sk-your-key"

Sampler- en presetbasis

Chat Completion-bronnen tonen een kleine set samplers: temperature, top P, frequency penalty en presence penalty, plus antwoordlengte en contextgrootte. Geavanceerdere samplers waar je misschien over gelezen hebt (min P, mirostat, dynamic temperature) horen bij Text Completion-backends en worden simpelweg niet naar gehoste chat-API's gestuurd, dus zoek er hier niet naar. Presets in SillyTavern bundelen twee dingen: samplerwaarden en de promptstructuur die de Prompt Manager samenstelt uit je character card, persona en lorebook. De ingebouwde Default-preset is een prima startpunt. Wijzig één waarde tegelijk en genereer dezelfde scène opnieuw om te zien wat het echt doet. Contextgrootte verdient aandacht: SillyTavern vult het contextvenster met chatgeschiedenis, dus een groter context betekent meer prompttokens per beurt, wat het geheugen verbetert en tegelijk de kosten per bericht verhoogt.

Aanbevolen modellen voor SillyTavern

Modelkeuze is belangrijker dan sampertuning. Communityconsensus, voor zover de indrukken bij benadering gaan, zet de DeepSeek V4-familie op de eerste plek qua prijs: deepseek-v4-flash is de standaardaanbeveling voor lange chats en deepseek-v4-pro houdt complexe cards en groepschats beter samen. GLM-5, Kimi K2.6 en MiMo zijn solide waardekeuzes met een eigen prozastem, de moeite waard om te rouleren als een chat begint te voelen als meer van hetzelfde. Grok valt op omdat het gepubliceerde beleid van xAI expliciet volwassen thema's in fictieve settings toestaat, wat van belang is voor donkerdere verhaallijnen. Claude schrijft het beste proza van alles op deze lijst, maar het beleid van Anthropic verbiedt expliciete inhoud, dus behandel Claude als de keuze voor SFW creatief schrijven en literaire scènes. Twee praktische opmerkingen. Ten eerste: SillyTavern is software gericht op volwassenen, en elk model hier handhaaft het eigen contentbeleid van zijn provider, ongeacht je frontend, dus houd cards en scènes binnen die regels. Ten tweede: omdat de lijst live gevuld wordt vanuit /v1/models, kun je midden in een chat van model wisselen en antwoorden op hetzelfde bericht vergelijken, wat de snelste manier is om je eigen favoriet te vinden.

Wat SillyTavern-chats werkelijk kosten

Gehoste modellen factureren per token, en roleplay is inputzwaar: elke beurt stuurt de character card plus recente geschiedenis opnieuw mee. Een beurt die 8,000 prompttokens stuurt en een antwoord van 350 tokens terugkrijgt, kost ongeveer een tiende cent op deepseek-v4-flash, dus een paar dollar dekt maanden van casual chatten. Dezelfde beurt op claude-opus-4-7 kost ruwweg 25 keer zoveel, wat verklaart waarom de meeste mensen een goedkoop dagelijks model draaien en premium modellen bewaren voor scènes waar ze om geven. Eén gateway-key dekt deze hele tabel. APIsRouter is een OpenAI-compatibele gateway met pay-as-you-go facturering en geen abonnement: je betaalt op /topup zonder een account aan te maken, de key komt per e-mail binnen, je eerste storting krijgt een bijpassende +100% op je saldo, wereldwijde modellen zijn 20% onder de officiële tarieven geprijsd en Chinese modellen liggen onder hun officiële prijzen.

Veelgestelde vragen