NL ▾
API-sleutel verkrijgen

SillyTavern API-configuratie: verbinding maken als OpenAI-compatibel

We leggen uit hoe je de URL, sleutel, modelnaam en contextwaarden instelt in de SillyTavern API-configuratie, inclusief verificatiecommando's.

Laatst bijgewerkt

Kernpunten

  • Kies voor aangepaste verbinding (OpenAI-compatibel) bij Chat Completion
  • URL is https://api.mukenetsuapi.com/v1, modelnaam: uncensored
  • Het contextvenster kan tot 100.000 tokens aan, maar voor kosten en snelheid is het realistischer om dit te beperken.
  • 401 wijst op de sleutel, 404 op de URL, 429 op gelijktijdige verzoeken of rate limits
Afbeelding van de API-aansluiting van SillyTavern: maskers en serverstekkers verbonden met lichtgevende kabels.

Bereid eerst 3 benodigdheden voor

De sillytavern API-configuratie is kort; fouten zitten vaak in de invoer. Zorg dat je de volgende 3 hebt.

SillyTavern is een frontend die een OpenAI-compatiele endpoint kan toevoegen. Je hoeft geen officiële OpenAI-service te gebruiken; je kunt deze API gewoon als aangepaste endpoint registreren.

Verbindingsstappen

Menu-items kunnen per versie verschillen. We beschrijven hier de algemene workflow. Raadpleeg bij afwijkingen ook de officiële SillyTavern-documentatie.

  1. Open 'API Connections' (pictogram met stekker) bovenaan.
  2. Selecteer 'Chat Completion' als API-type.
  3. Kies in de bronlijst voor 'Custom' (OpenAI-compatibel).
  4. Voer de endpoint URL https://api.mukenetsuapi.com/v1 in. Voeg /chat/completions niet toe aan het eind.
  5. Plak de gegenereerde sleutel in het veld voor de API-sleutel. Zorg dat er voor en na de sleutel geen spaties staan.
  6. Stel de modelnaam in op uncensored. Kies uit de lijst of typ de naam handmatig.
  7. Klik op Verbinden en controleer of de verbinding succesvol is.

Controleer vooraf via de terminal of je sleutel en URL correct zijn, zodat je problemen sneller kunt lokaliseren.

curl https://api.mukenetsuapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "こんにちは"}], "max_tokens": 50}'

Als je een respons ontvangt, zijn je sleutel, URL en modelnaam correct. Als SillyTavern dan nog faalt, controleer dan de invoer in de app.

Context en responslengte instellen

De context van deze API kan tot 100.000 tokens beslaan voor prompt en output. We raden echter af de maximale contextgrootte in SillyTavern te gebruiken. Elke keer stuur je de karakterinstellingen, de wereldbeschrijving en de geschiedenis opnieuw, wat bij hogere waarden de invoer per keer vergroot.

Voorbeeld kostenberekening

Als je context tot 16.000 tokens gebruikt en de respons 300 tokens is, ziet de kosten per bericht er als volgt uit:

  • Invoer: 16.000 ÷ 1.000.000 × $0,15 = $0,0024
  • Uitvoer: 300 ÷ 1.000.000 × $0,50 = $0,00015
  • Totaal: $0,00255

100 berichten kosten $0,255. Als je het contextvenster halveert naar 8.000, wordt de invoerkant ongeveer de helft. Zie de prijzenpagina voor details over de tarieven.

Richtlijn

Als het geen lang verhaal of een scène met veel personages is, is het realistisch om te beginnen bij 8.000 tot 16.000 en dit pas te verhogen als je het gevoel hebt dat karakters hun eerdere ervaringen vergeten. De maximale lengte van het antwoord pas je aan aan de gewenste lengte van de respons. max_tokens is optioneel, maar het is veilig om in SillyTavern een limiet in te stellen als je te lange antwoorden wilt vermijden.

Benadering van sampling-instellingen

temperature, top_p, stop, seed en diverse strafwaarden worden rechtstreeks doorgegeven aan de API. Je kunt deze aanpassen met de presets van SillyTavern.

  • Herhaling van dezelfde zinswendingen: verhoog de penalties voor frequency en presence iets.
  • Antwoord is te wijdlopig: verlaag de temperatuur.
  • Antwoord is te eentonig: verhoog de temperatuur iets.
  • Vergelijk: fix de seed en verander de waarde met 1.

De namen van de preset-items verschillen per versie van SillyTavern. Als de instellingen niet worden toegepast, controleer dan in de documentatie van SillyTavern of de gebruikte verbindingsmethode ondersteuning biedt voor dat item.

Veelvoorkomende fouten en oplossingen

SymptoomMogelijke oorzaakOplossing
401Verkeerde sleutel, spaties erinPlak de sleutel opnieuw en test deze met curl.
404Verkeerde URLControleer of de URL eindigt op /v1.
Model niet gevondenSpelfout in modelnaamVoer uncensored in met kleine letters.
429 (concurrency)Te veel gelijktijdige verzoekenVerminder het snel achter elkaar swipen of gelijktijdige generatie in groepschats.
429 (rate_limited)Te veel verzoeken per minuutWacht een beetje.
429 (met Retry-After: 5)Tijdelijke congestieWacht 5 seconden en probeer het opnieuw.

De limieten voor volledige sleutels zijn 8 gelijktijdig, 300 per minuut; voor proefsleutels zijn dat 2 gelijktijdig, 60 per minuut. Een streaming-antwoord gebruikt 1 gelijktijdige verbinding tot het antwoord klaar is. Als je groepschat met een proefsleutel uitvoert, is de limiet snel vol.

Je kunt controleren of je saldo voldoende is met het volgende commando.

curl https://api.mukenetsuapi.com/v1/balance \
  -H "Authorization: Bearer YOUR_API_KEY"

Je kunt het ook aflezen uit de response header X-Balance-USD. Voor een overzicht van de modellen voer je GET /v1/models uit.

curl https://api.mukenetsuapi.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Let op bij gebruik

Deze API is alleen voor tekst. Als je de afbeeldings- of audiofuncties van SillyTavern wilt gebruiken, heb je een andere service nodig. De inhoud is bedoeld voor fictie zoals romans, rollenspellen en companion-apps binnen de legale grenzen voor volwassenen. Seksuele inhoud met minderjarigen wordt in elke configuratie onderdrukt. Je prompts worden niet gebruikt voor het trainen van het model.

Meer gedetailleerde parameters vind je in de documentatie. Betalen kan met USDT (TRC20) of USDC (Base) in bedragen van $20 tot $500.

Andere handleidingen

Veelgestelde vragen

Welke modelnaam gebruik ik in SillyTavern?

uncensored. Voer het met kleine letters direct in.

Moet ik /chat/completions aan het einde van de URL toevoegen?

Niet nodig. De base URL eindigt op /v1; het resterende pad wordt door de app toegevoegd.

Is een proefsleutel voldoende?

Voor een verbindingstest of een kort gesprek is het voldoende. Een proefsleutel is echter beperkt tot 2 gelijktijdige en 60 per minuut, en is 7 dagen geldig. Laad een reguliere sleutel op als je groepschats wilt gebruiken.

Kan ik ook afbeeldingen genereren?

Nee. Deze API is alleen voor tekst en ondersteunt geen afbeeldingen, audio of video.

Hoe groot moet het contextvenster zijn?

Het maximum is 100.000 tokens, maar het is realistisch om te beginnen met 8.000 tot 16.000. Hoe groter, hoe meer invoer per keer en hoe hoger de kosten.

API-sleutels zijn verkrijgbaar via 1 formulier

Account aanmaken, sleutel kopiëren, base URL aanpassen. Dat is alles wat je hoeft te doen om klaar te zijn.

API-sleutel ophalen