NL ▾

SillyTavern API-instellingen: OpenAI-compatibele API instellen

De SillyTavern API-instellingen zijn snel klaar als je vier waarden klaar hebt: bron, basis-URL, sleutel en modelnaam. Hier lees je wat je moet invullen, hoe je context en antwoordlengte kiest en wat helpt bij fouten.

Ongecensureerde AI: LLM-API vs. Lokale modellen vs. Clouddiensten

Bijgewerkt

Podium met maskers en lichtgevende tekstballonnen die naar een stekker leiden: SillyTavern verbinden met een API

Belangrijke punten

  • Je voert een OpenAI-compatibele bron, de basis-URL, de API-sleutel en de modelnaam uncensored in.
  • De contextgrootte in de client moet passen bij het 100.000-token contextvenster van de API en bij je budget.
  • Veelgemaakte fouten zijn een verkeerde basis-URL of een typefout in de sleutel.
  • Roleplay kost per bericht een fractie van een cent, omdat de geschiedenis elke keer wordt meegestuurd.

De vier waarden die je nodig hebt

SillyTavern is een frontend voor chats en roleplay met personagekaarten. Het kan verbinden met verschillende tekstbronnen, waaronder endpoints die het OpenAI-formaat spreken. Voor de verbinding heb je precies vier gegevens nodig:

  • Bron: een OpenAI-compatibele of aangepaste chat-completie-bron
  • Basis-URL: https://api.unzensiertesllm.com/v1
  • API-sleutel: jouw sleutel van de pagina API-sleutel verkrijgen
  • Modelnaam: uncensored

De namen van menu's en velden kunnen tussen SillyTavern-versies verschillen. Houd je aan de bovenstaande termen en lees bij afwijkingen de documentatie van SillyTavern zelf.

Stap voor stap verbinden

  1. Meld je aan bij ons (via Google of e-mail met wachtwoord) en maak de sleutel aan. Na het inloggen haal je met één klik $0,50 testtegoed op: één keer per persoon, 7 dagen geldig, zonder betalingsgegevens.
  2. Open in SillyTavern het gedeelte voor API-verbindingen.
  3. Kies als API-type de chat-completie-variant en als bron de aangepaste, OpenAI-compatibele invoer (de exacte namen hangen van je versie af).
  4. Voer de basis-URL in met de suffix /v1.
  5. Voeg de sleutel in, zonder spaties aan het begin of einde.
  6. Geef als model uncensored op of selecteer het uit de lijst, als de client de modellen opvraagt.
  7. Verbind en stuur een kort testbericht.

Toont de client een modellenlijst, dan roept hij GET /v1/models op. Verschijnt daar uncensored, dan kloppen adres en sleutel.

Verbinding vooraf buiten SillyTavern controleren

Als iets niet lukt, controleer dan adres en sleutel gescheiden van de client. Dat bespaart raden.

curl https://api.unzensiertesllm.com/v1/models \
  -H "Authorization: Bearer DEIN_SCHLUESSEL"

curl https://api.unzensiertesllm.com/v1/chat/completions \
  -H "Authorization: Bearer DEIN_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Sag kurz Hallo."}], "max_tokens": 30}'

Antwoordt curl, dan ligt het probleem bij de client. Antwoordt curl niet, dan komt het door sleutel, adres of netwerk. Het resterende tegoed zie je in de antwoordheader X-Balance-USD.

Contextgrootte en antwoordlengte goed kiezen

Twee regelaars bepalen hoeveel er per bericht wordt meegestuurd en gegenereerd:

  • Contextgrootte (Context Size): Hoeveel tokens geschiedenis, personagebeschrijving en wereldinformatie samen meegaan. De API staat tot 100.000 tokens toe voor prompt en antwoord samen. Je hoeft dit niet uit te putten. Voor veel rollenspellen zijn enkele duizenden tokens genoeg, en elke token context kost bij elk bericht opnieuw.
  • Antwoordlengte (Response Length): Komt overeen met max_tokens. De opgaaf is bij de API optioneel; in de client stel je dit het beste in, zodat antwoorden niet uitwiden.

Een vuistregel: kies de contextgrootte zodat personagekaart, belangrijke notities en de laatste twaalf berichten passen. Alles ouder kan de client weggooien, of je vat het samen.

Sampler-waarden

De API geeft temperature, top_p, stop, seed en de penalty-parameters door. Begin met gematigde waarden, bijvoorbeeld een temperatuur van 0,8, en pas steeds maar één instelling aan. Andere samplers die SillyTavern voor bepaalde bronnen aanbiedt, worden door deze endpoint mogelijk niet ondersteund; ze blijven dan zonder effect. Controleer dit in de documentatie.

Wat een roleplaysessie kost

Prijzen: $0,15 per 1M invoertokens, $0,50 per 1M uitvoertokens. Stel dat elke boodschap 8.000 tokens context verstuurt en 350 tokens antwoord ontvangt:

  • Invoer: 8.000 / 1.000.000 × $0,15 = $0,0012
  • Uitvoer: 350 / 1.000.000 × $0,50 = $0,000175
  • Totaal: $0,001375 per bericht

Een sessie met 200 berichten kost daarmee $0,275. Het testtegoed van $0,50 is genoeg voor ongeveer 363 van zulke berichten (0,50 / 0,001375 ≈ 363,6). Verdubbel je de context naar 16.000 tokens, dan stijgt de invoerkosten naar $0,0024 en het bericht naar $0,002575.

Je kunt elk bedrag van $20 tot $500 opwaarderen met USDT op TRC20 of USDC op Base. Vanaf $50 krijg je +5% bonus, vanaf $100 +10%, vanaf $200 +15%. Het tegoed vervalt niet. De schaal staat op de prijzenpagina.

Typische fouten en hun oplossing

Foutmelding of symptoomOorzaakOplossing
401 of authenticatiefoutSleutel verkeerd, afgeknipt of met spatiesOpnieuw plakken, controleren met curl
404 of model niet gevonden/v1 ontbreekt of modelnaam verkeerdVoer de basis-URL in met /v1, model uncensored
429 met concurrencyTe veel gelijktijdige verzoeken (testsleutel: 2, volledige sleutel: 8)Groepschats achter elkaar in plaats van parallel, streaming-tabbladen sluiten
429 met rate_limitedTe veel verzoeken per minuut (60 respectievelijk 300)Niet snel achter elkaar opnieuw laten genereren
429 met Retry-After: 5Kortstondige overbelastingWacht 5 seconden en stuur opnieuw
Antwoord breekt midden in een zin afAntwoordlengte in de client te kleinResponse Length verhogen
Fout door te lange contextDe geschiedenis alleen past niet in het contextvenster van 100.000 tokens (het antwoord wordt beperkt tot de resterende ruimte)Contextgrootte in de client verkleinen, oudere berichten inkorten

Een gestreamd verzoek belegt zijn plek in de limiet voor gelijktijdige verzoeken tot de stream eindigt. Dit verklaart sommige verrassende 429-meldingen als je meerdere chats open hebt.

Informatie over inhoud en privacy

Het model is afgestemd op fictie, rollenspel en companion-scenario's voor volwassenen zonder inhoudelijke weigering. Het gaat om een enkel open-weight model van een onafhankelijke aanbieder, niet om de officiële API van een grote fabrikant. Seksuele inhoud met minderjarigen is zonder uitzondering uitgesloten. De API levert alleen tekst; afbeeldingen of spraak worden niet gegenereerd. Prompts worden niet gebruikt voor training.

Meer over het kiezen van ongecensureerde modellen vind je in de vergelijking van ongecensureerde AI.

Meer handleidingen

Veelgestelde vragen

Welke basis-URL voer ik in SillyTavern in?

https://api.unzensiertesllm.com/v1, met de suffix /v1. Als model geef je uncensored op.

Welke contextgrootte is zinvol?

De API staat tot 100.000 tokens toe voor prompt en antwoord. Voor rollenspel zijn vaak enkele duizenden voldoende; hogere waarden verhogen de kosten per bericht.

Waarom krijg ik een 429-fout?

De foutcode geeft de oorzaak aan: rate_limited betekent te veel verzoeken per minuut, concurrency te veel gelijktijdige. Met de testsleutel gelden 60 per minuut en 2 gelijktijdig.

Wat kost een sessie met 200 berichten?

Bij 8.000 tokens context en 350 tokens antwoord ongeveer $0,275. Met meer context stijgt de prijs.

Je sleutel is slechts één klik verwijderd

Account aanmaken, sleutel kopiëren, basis-URL aanpassen. Klaar.

API-sleutel ontvangen