SillyTavern API-integratiegids: Verbind GPTProto en begin met roleplayen

Stap 1: Installeer en start SillyTavern

SillyTavern draait de chatinterface, karakterkaarten en promptinstellingen op je computer. Een verbonden model genereert de antwoorden. De officiële projectdocumentatie beschrijft het als een gratis, open-source frontend.

Zorg voor Node.js LTS, Git, een GPT Proto-account met beschikbaar API-tegoed en een model-ID. Cloud-inferentie via GPT Proto vereist niet dat je modelgewichten downloadt of een model op je GPU draait.

Installeren op macOS

Download de LTS-versie van de Node.js downloadpagina, selecteer macOS en gebruik het installatieprogramma als je de voorkeur geeft aan een grafische installatie.

Kies de huidige LTS-release voor jouw besturingssysteem.

Open Terminal en controleer Git:

git --version

Installeer Git indien nodig en voer daarna uit:

cd ~
git clone https://github.com/SillyTavern/SillyTavern -b release
cd SillyTavern
bash start.sh

De eerste keer opstarten installeert de afhankelijkheden. Houd de terminal open terwijl je SillyTavern gebruikt en open het lokale adres dat daar wordt weergegeven als de browser niet automatisch opent. Deze opdrachten volgen de officiële macOS-installatie-instructies.

De eerste keer opstarten downloadt de vereiste afhankelijkheden.

Om het later opnieuw te starten:

cd ~/SillyTavern
bash start.sh

Installeren op Windows

Installeer Node.js LTS en Git for Windows. Maak een map aan zoals C:\AI, open deze in Verkenner, typ cmd in de adresbalk en druk op Enter. Voer uit:

git clone https://github.com/SillyTavern/SillyTavern -b release

Open de gedownloade SillyTavern map en dubbelklik op Start.bat. Laat de console openstaan tijdens het chatten. De officiële Windows-handleiding raadt aan om door Windows beheerde mappen zoals Program Files te vermijden en het opstartbestand uit te voeren zonder beheerdersrechten.

Stap 2: Verbind SillyTavern met GPT Proto

Meld je aan bij GPT Proto en open de GLM-5.3 modelpagina. In de sectie API-gebruik vind je de model-ID en een optie om een API-sleutel aan te maken. Maak je sleutel aan of selecteer er een, controleer het huidige tarief en zorg voor voldoende saldo voor een kleine test.

Open in SillyTavern API-verbindingen via het stekker-icoon in de bovenste balk. Voer het volgende in:

Plak de sleutel zelf in het sleutelveld. Voeg daar geen Bearer, aanhalingstekens of een volledige HTTP-header toe.

De officiële instructies voor Custom endpoints specificeren een basis-URL zonder /chat/completions; SillyTavern voegt dat achtervoegsel zelf toe. Voor deze verbinding moet het endpoint-veld eindigen op /v1.

Als je eerder onze Janitor AI API-installatiegids hebt gevolgd, let dan op dit verschil: de Proxy-URL van Janitor gebruikt het volledige https://gptproto.com/v1/chat/completions adres. Het kopiëren van dat volledige adres in het veld Basis-URL van SillyTavern zou resulteren in een onjuiste invoer.

Laat de bron, basis-URL, sleutel en model-ID overeenkomen met de bovenstaande velden.

Klik op Connect en vervolgens op Test Message. Je kunt ook Hello sturen vanaf het welkomstscherm. De walkthrough leverde het onderstaande antwoord op.

Een basisbericht bevestigt dat de verbinding een antwoord kan genereren.

Een lege lijst met beschikbare modellen betekent niet noodzakelijkerwijs dat generatie niet beschikbaar is. Voer de exacte ID handmatig in wanneer modeldetectie niet werkt. Om later van model te wisselen, gebruik je een andere ondersteunde GPT Proto tekstmodel-ID en test je opnieuw; modelfuncties en geaccepteerde parameters kunnen verschillen.

Stap 3: Importeer een karakterkaart of maak er zelf een

Een werkende API-verbinding levert het model. De karakterkaart levert de identiteit, stem en beginsituatie.

Importeer een bestaande karakterkaart

Open Characters → Import Character, selecteer het gedownloade kaartbestand en kies het geïmporteerde karakter om te beginnen met chatten. Je kunt ook door karakters bladeren via Extensions → Download Extensions & Assets.

Download voor PNG-kaarten het originele bestand. Een normale portretfoto of screenshot bevat geen bruikbare karakterdefinitie, tenzij die gegevens in de afbeelding zijn ingesloten. De officiële FAQ legt uit waarom PNG-imports ongeldig kunnen zijn, inclusief gevallen waarin het opslaan of verwerken van een afbeelding de ingesloten gegevens verwijdert.

Maak Noah Bennett aan vanuit tekst

Kies Create New Character. Begin met de Naam, Beschrijving en het Eerste Bericht; je kunt later geavanceerde velden toevoegen. De beschrijving vertelt het model over het personage. Het eerste bericht zet de openingsscène neer en laat de stijl zien die je wilt. De character design guide legt beide velden uit.

Gebruik de personage-editor voor de identiteit en openingsscène van de AI.

Stel Name in op Noah Bennett. Plak dit originele voorbeeld in Description. {{char}} verwijst naar het personage en {{user}} naar de door jou geselecteerde gebruikersidentiteit.

Je speelt de rol van {{char}}, Noah Bennett, een 25-jarige man met een gespierd postuur, een makkelijke glimlach en een warme, liefdevolle persoonlijkheid.

UITERLIJK
Noah is 188 cm lang, met brede schouders, sterke armen, een gedefinieerde borstkas en sterke benen die zijn opgebouwd door jarenlange krachttraining. Hij heeft licht warrig donkerbruin haar, warme hazelnootkleurige ogen, lichte stoppels en een kuiltje dat verschijnt wanneer hij grijnst. Zijn gebruikelijke kleding bestaat uit nauwsluitende T-shirts, comfortabele joggingbroeken en sneakers. Zijn stem is laag en warm, en hij lacht makkelijk.

PERSOONLIJKHEID
Noah is een lieverd met speels zelfvertrouwen. Hij is attent, fysiek expressief en vindt het prettig om genegenheid te tonen. Hij geniet ervan om {{user}} te laten glimlachen door middel van zachte plagerijen, attente gebaren en oprechte complimenten. Zijn aantrekkingskracht komt voort uit de combinatie van zijn imposante bouw en zijn verrassend zachte hart.

Hij heeft zijn eigen meningen, vriendschappen, ambities en af en toe een slechte dag. Soms verbergt hij nervositeit achter een grapje en raakt hij schattig in de war wanneer {{user}} hem betrapt op sentimenteel gedrag. Hij kan fouten toegeven en om zichzelf lachen.

ACHTERGROND
Noah werkt als krachttrainer en hoopt een kleine sportschool in de buurt te openen. Buiten zijn werk houdt hij van koken, wandelen, vreselijke romantische komedies en experimenteren met pannenkoekenrecepten. Hij neemt training serieus, maar beoordeelt mensen nooit op hun lichaam of fitnessniveau.

RELATIE MET {{user}}
Noah en {{user}} zijn vriendelijke buren die onlangs meer tijd met elkaar zijn gaan doorbrengen. Hij voelt zich aangetrokken tot {{user}} en maakt zijn interesse duidelijk door aandacht, speels flirten en uitnodigingen om samen alledaagse dingen te doen. Laat hun band groeien door echte interacties.

FLIRTSTIJL
Zijn manier van flirten is warm, specifiek en licht brutaal. Hij houdt misschien net iets langer oogcontact, onthoudt een favoriet drankje of geeft toe dat hij een excuus zocht om langs te komen. Hij merkt de reacties van {{user}} op en past zich op natuurlijke wijze aan. Genegenheid moet welkom en wederzijds aanvoelen.

ROLEPLAY-STIJL
Blijf in de rol van Noah tijdens het verhaal. Gebruik natuurlijke dialogen, kleine fysieke gebaren en concrete details in plaats van langdradige persoonlijkheidsuitleg.
Schrijf acties tussen *asterisken* en dialogen tussen aanhalingstekens.
Reageer meestal in één tot drie korte alinea's, zodat er ruimte blijft voor {{user}} om deel te nemen.
Bestuur alleen Noah's spraak, acties en gedachten. Laat de dialoog, beslissingen en gevoelens van {{user}} aan de gebruiker over.
Behoud vastgestelde details en reageer direct op wat er zojuist is gebeurd.
Gebruik natuurlijk Engels, tenzij {{user}} om een andere taal vraagt.

Plak dit in First Message:

*Noah staat voor je deur met een sporttas over zijn brede schouder en een klein papieren zakje in zijn hand. Zijn donkere haar is nog een beetje vochtig en zijn nauwsluitende grijze T-shirt heeft een klein beetje bloem bij de zoom.*

"Voordat je iets zegt—ja, ik kan meer koken dan alleen kip met rijst."

*Hij tilt het papieren zakje op, terwijl er een kuiltje in zijn wang verschijnt bij zijn glimlach.*

"Kaneelbroodjes. Ik heb er te veel gemaakt." *Een korte pauze.* "Oké, ik heb er extra gemaakt omdat ik hoopte je te zien."

"Dus… heb je tijd voor een kop koffie?"

Voltooi het aanmaken van het personage en selecteer vervolgens Noah. Houd de kerninstructies in de Beschrijving en de opening in het Eerste Bericht. De Notities van de maker bieden metadata voor mensen die de kaart lezen en worden niet gebruikt om de model-prompt op te bouwen.

De voltooide Noah-kaart scheidt zijn voortdurende identiteit van zijn openingsgroet.

Stel je eigen Persona in

Personages bepalen de identiteit van de AI. Persona's bepalen die van jou. Open Persona Management, maak een persona aan en selecteer deze, en voeg optioneel een naam, avatar en beschrijving toe, volgens de officiële Persona-instructies.

Voor deze fictieve scène is een korte beschrijving voldoende:

{{user}} is een volwassene die onlangs in de buurt is komen wonen. Noah en {{user}} zijn vriendelijke buren die elkaar leren kennen. {{user}} bepaalt zelf zijn/haar/hun eigen spraak, acties, keuzes en gevoelens.

Gebruik fictieve details die je wilt dat het personage kent; je hoeft je echte biografie niet in te voeren. Voor meer ideeën over het schrijven van personages, zie hoe je je eigen AI-personage maakt met een API.

Stap 4: Start je eerste rollenspel-gesprek

Open de chat van Noah en lees de begroeting. In de schermafbeelding antwoordt de gebruiker ja, en Noah reageert: “Ja? Oké. Geweldig.” Hij vervolgt daarna de uitnodiging voor koffie met acties en dialoog. Die gegenereerde voortzetting is de nuttige verbindingscontrole.

Voor een specifiekere prompt om zelf te proberen, stuur:

"Dus de kaneelbroodjes waren slechts een excuus om me te zien?"
*Ik werp een blik op de papieren zak en kijk dan weer naar hem.*

Controleer of het antwoord de persoonlijkheid van Noah volgt, reageert op je laatste invoer en jouw beslissingen aan jou overlaat. Als de stijl verbetering behoeft, bewerk dan één deel van de kaart en probeer een nieuwe chat. Vermijd het tegelijkertijd wijzigen van het model, de personage-prompt en diverse instellingen; je zult dan minder informatie hebben over wat heeft geholpen.

Optioneel: Voeg Wereldinfo toe aan je personage

Wereldinfo, ook wel een lorebook genoemd, voegt instellingsinformatie toe aan de prompt onder geconfigureerde voorwaarden. Voeg voor een eerste experiment één locatie uit de scène van Noah toe.

Open Wereldinfo, maak een lorebook aan en voeg een ingeschakeld item toe met de strategie op basis van trefwoorden. Gebruik deze voorbeeldwaarden:

Gebruik in het personagepaneel van Noah Meer… → Koppel Wereldinfo, of de wereldbol-knop voor personage-lore, om het lorebook aan hem te koppelen. Vraag daarna: Hoe is Corner Cafe?

De documentatie over Wereldinfo legt uit dat de Inhoud van een item in de prompt wordt ingevoerd; de titel alleen levert de feiten niet. Activering hangt ook af van instellingen en het beschikbare budget, en het model gebruikt mogelijk niet elk verstrekt detail. Begin met één beknopt item en controleer het gedrag voordat je een grote wereld toevoegt.

Hoeveel kost SillyTavern met GPT Proto?

GLM-5.3 is het model dat voor deze walkthrough wordt gebruikt. Kies je model op basis van budget, natuurlijkheid van de dialoog, emotionele expressie, karakterconsistentie en reactiesnelheid. Vergelijk kandidaten met dezelfde kaart en openingsscène. Houd bij dagelijkse chats rekening met de kosten voor behouden context in je budget; controleer bij verhaalgedreven scènes of de stem geloofwaardig aanvoelt en of het model de keuzes aan jou laat.

SillyTavern zelf is gratis. Voor het genereren van modellen via GPT Proto wordt je API-saldo gebruikt. Op het moment van schrijven van deze handleiding is GLM-5.3 15% goedkoper dan de officiële input- en outputtarieven op GPT Proto:

Tarieven gecontroleerd op 3 november 2026. Zie het GLM-5.3 prijsdashboard voor actuele tarieven en eventuele toepasselijke cache-prijzen.

Een illustratief verzoek met 8.000 niet-gecachte input-tokens en 500 factureerbare output-tokens kost:

(8.000 ÷ 1.000.000 × $1,19) + (500 ÷ 1.000.000 × $3,74)
= $0,01139

Dit is een rekenvoorbeeld, niet de gemeten factuur voor de screenshot-conversatie. Factureerbare output is geen woordentelling; gebruik het door de provider gerapporteerde gebruik, inclusief eventuele redeneertokens die als output worden gefactureerd.

Input kan karakterinstructies, Persona, geselecteerde lore en behouden gespreksgeschiedenis bevatten. Zoals het API-verbindingsoverzicht uitlegt, stelt SillyTavern deze samen in de prompt. Een langere behouden context kan de kosten van een antwoord verhogen, zelfs als je nieuwste bericht slechts ja is.

Waarom kiezen voor GPT Proto voor je SillyTavern API?

GPT Proto biedt officiële provider-modellen met kortingstarieven op geselecteerde modellen, waaronder GLM-5.3. Eén sleutel en een gedeeld saldo dekken meerdere providers. Behoud in SillyTavern je karakterkaarten en aangepaste verbinding, schakel over naar een ander ondersteund chatmodel-ID en vergelijk de antwoorden.

Voor betrouwbaarheid gebruiken grote modellen redundante upstream-kanalen en automatische failover om onderbrekingen te helpen verminderen wanneer een kanaal onbeschikbaar wordt. Je kunt kiezen tussen modellen met verschillende prijzen en gespreksstijlen terwijl je je instellingen behoudt.

Controleer vóór een lange sessie de beschikbaarheid van het model, de input/output-kosten, de reactiesnelheid en de gegevensverwerking. Begin met een kleine test en bekijk het gebruik. Op de SillyTavern-modelpagina kun je opties verkennen en kosten vergelijken.

Veelvoorkomende SillyTavern API-problemen en oplossingen

Begin met een nieuwe chat en een kort bericht. Koppel vervolgens het symptoom aan de volgende controle:

Redeneermodellen vereisen extra aandacht. De officiële redeneergids legt uit dat denken responstokens kan verbruiken, zelfs als dit verborgen is. Een toelage die te klein is voor dat model kan resulteren in een leeg of onvolledig zichtbaar antwoord. Controleer de maximale responslengte (Max Response Length) aan de hand van de vereisten van het model in plaats van dezelfde kleine limiet op elk model toe te passen.

Eén communitydiscussie over lorebooks en lege antwoorden beschrijft een gebruiker die herstelde na het verwijderen van een preset en het verhogen van de responstoelage. Beide werden tegelijkertijd gewijzigd, dus het rapport isoleert niet één specifieke oorzaak. Het ondersteunt wel een praktische volgorde voor probleemoplossing: zorg dat een eenvoudige chat werkt en voeg daarna presets en lore één voor één toe.

Optioneel: Test de API buiten SillyTavern

Met je sleutel privé opgeslagen in de GPTPROTO_API_KEY omgevingsvariabele, verstuurt dit macOS/Linux-shellcommando een direct verzoek met behulp van het Chat Completions-formaat van de modelpagina:

curl --request POST "https://gptproto.com/v1/chat/completions" \
  --header "Authorization: Bearer $GPTPROTO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "glm-5.3",
    "messages": [
      {"role": "user", "content": "Reply with: API connection works."}
    ]
  }'

Controleer op een succesvol antwoord met gegenereerde tekst, niet alleen een verbindingsindicator. Als dit werkt terwijl SillyTavern faalt, vergelijk dan de velden en toegevoegde parameters van de client. Als beide falen, onderzoek dan de geretourneerde authenticatie-, saldo-, model- of servicefout. Houd echte sleutels uit openbare berichten over probleemoplossing.