Janitor AI proxy instellen: URL-formaat, modellen en 429-oplossingen

Kort antwoord: de drie velden die JanitorAI vraagt

De proxyconfiguratie van JanitorAI vraagt precies drie waarden: een proxy-URL, een modelnaam en een API-sleutel. De proxy-URL moet het volledige chat completions-endpoint zijn, geen base-URL. Geeft je provider je een base-URL die eindigt op /v1, voeg dan /chat/completions toe voordat je hem in JanitorAI plakt. Dit ene detail veroorzaakt meer mislukte installaties dan al het andere samen. Voer de model-ID precies in zoals de provider hem spelt, kleine letters en streepjes inbegrepen, sla dan op en stuur een kort testbericht. Komt er een antwoord terug, dan ben je klaar. Krijg je in plaats daarvan een foutcode, spring dan naar de foutentabel hieronder. Elke veelvoorkomende code heeft een specifieke oorzaak en een specifieke oplossing.

Proxy-URL:    https://api.apisrouter.com/v1/chat/completions
Model:        deepseek-v4-flash
API-sleutel:  sk-...   (exact plakken, geen aanhalingstekens, geen spaties erachter)

Wat "proxy" betekent in de JanitorAI-community

Het woord is misleidend. In JanitorAI-jargon is een proxy geen netwerkproxy of VPN. Het is elk OpenAI-compatibel API-endpoint waar de site je chatverzoeken naartoe stuurt in plaats van naar zijn standaardbackend. De community nam de term jaren geleden over toen mensen chats begonnen te routeren via reverse proxy's van provider-API's, en de naam bleef hangen ook al praten de meeste installaties tegenwoordig rechtstreeks met een provider of gateway. Mensen draaien een proxy om drie redenen. Ten eerste modelkeuze: je kiest precies welke LLM je personages schrijft in plaats van te accepteren wat de site standaard gebruikt. Ten tweede kwaliteit: modellen zoals DeepSeek V4 of Claude schrijven langere, samenhangendere scènes dan een gratis ingebouwde tier. Ten derde kostenbeheersing: met een per-token gefactureerde sleutel zie je precies wat elke chat kost in plaats van te betalen voor een abonnement dat je misschien niet volledig gebruikt. Er zijn drie soorten endpoints die je in de community ziet delen. Officiële provider-API's (OpenAI, Anthropic, xAI, DeepSeek) vereisen een account bij elke aanbieder. Gateways bundelen veel modellen achter één OpenAI-compatibele URL en één sleutel. Community "gratis proxy's" zijn gedeelde sleutels die iemand anders betaalt, en dat is waarom ze onstabiel zijn en zwaar geratelimit worden. Nog iets dat het waard is om ronduit te zeggen: welk endpoint je ook gebruikt, het contentbeleid van de upstream modelprovider blijft gelden voor elk antwoord, en de eigen voorwaarden van JanitorAI, inclusief de eis van alleen volwassenen, blijven het platform beheersen. Beide beleidslijnen kennen voordat je een model kiest, bespaart je weigeringen midden in een scène.

Volledige installatie: van API-sleutel tot eerste antwoord

Wil je één sleutel die DeepSeek, GLM, Kimi, Claude, Gemini en Grok tegelijk dekt, dan is een OpenAI-compatibele gateway zoals APIsRouter de weg met de minste wrijving: checkout op /topup vereist geen accountregistratie, de sleutel komt per e-mail, en de proxy-URL voor JanitorAI is https://api.apisrouter.com/v1/chat/completions. Eén nuance als je ook SillyTavern gebruikt: SillyTavern wil de base-URL die eindigt op /v1 en vult zijn modellenlijst automatisch via /v1/models met je sleutel, terwijl JanitorAI het volledige pad inclusief /chat/completions wil. Zelfde endpoint, ander deel van de URL. De twee formaten door elkaar halen is de belangrijkste oorzaak van 404-fouten in beide apps.

• Haal een API-sleutel op bij een OpenAI-compatibele provider of gateway. Je hebt de sleutelstring en de gedocumenteerde endpoint-URL nodig.
• Open een willekeurige characterchat op JanitorAI, open dan API Settings en selecteer de Proxy-optie.
• Plak de volledige endpoint-URL die eindigt op /chat/completions in het proxy-URL-veld.
• Typ de model-ID precies zoals gedocumenteerd, bijvoorbeeld deepseek-v4-flash of glm-5.
• Plak de API-sleutel, sla de instellingen op, en ververs de pagina als het opslaan niet doorkomt.
• Stuur een testbericht van één regel. Een normaal antwoord betekent dat de hele keten werkt.

Test het endpoint met curl voordat je JanitorAI de schuld geeft

Als een proxy zich misdraagt, test het endpoint dan eerst buiten JanitorAI. Een curl-aanroep van 10 seconden vertelt je of het probleem bij het endpoint, de sleutel, of de manier waarop je de site hebt geconfigureerd ligt. Voer dit uit in een willekeurige terminal, met je eigen sleutel en model:

curl https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Reply with one short sentence."}]
  }'

Fout 429: waarom gratis proxy's ratelimiten op piekmomenten

Een 429-antwoord betekent "te veel verzoeken". Het is verreweg de meest gemelde proxyfout in de JanitorAI-community, en het patroon erachter is voorspelbaar. Een gratis of gedeelde proxy is één API-sleutel die honderden of duizenden gebruikers bedient. Providers handhaven per-sleutel-limieten op verzoeken per minuut en tokens per minuut, dus wanneer het Amerikaanse avondverkeer piekt, gaat iedereen door dezelfde quota en begint de sleutel verzoeken te weigeren. Je wordt niet persoonlijk geraakt. De emmer is gewoon leeg, en die vult zich het langzaamst precies wanneer de meeste mensen willen chatten. Gratis proxy's hebben een tweede faalmodus: de sleutel zelf sterft. Gedeelde sleutels worden ingetrokken wegens beleidsschendingen of uitgeput saldo, waarna dezelfde URL in plaats daarvan 401 of 404 begint terug te geven, vaak zonder aankondiging. Betaalde endpoints vermijden de piekurenmuur structureel. Jouw sleutel krijgt een eigen quota in plaats van één emmer te delen met een menigte, facturering gaat per token dus heeft de provider geen reden om je naar een abonnementstier te dwingen, en capaciteit is voorzien voor betalend verkeer. Zie je een 429 op een persoonlijke betaalde sleutel, dan is het bijna altijd een korte burstlimiet: wacht een paar seconden en probeer opnieuw, of vertraag razendsnelle regenerates. Aanhoudende 429's op een persoonlijke sleutel zijn een supportticket waard, geen workaround.

JanitorAI proxy-foutentabel: 429, 401, 404, timeout

Vergelijk de code die JanitorAI je toont met deze tabel. De oplossingskolom gaat ervan uit dat je al hebt bevestigd dat het endpoint werkt met de curl-test hierboven; faalt curl op dezelfde manier, dan ligt het probleem bij het endpoint, niet bij JanitorAI.

Welk model je achter je Janitor AI-proxy draait

Modelkeuze doet er meer toe dan elke aanpassing van generatie-instellingen. De consensus in de community is stabiel: de DeepSeek V4-familie is de favoriet voor roleplay omdat het lange, in-character antwoorden schrijft tegen prijzen waarbij kosten geen overweging meer zijn. GLM-5, Kimi K2.6 en MiMo zijn de waardekeuzes die het waard zijn om te doorlopen als je een andere stem wilt. Grok 4.5 wordt vermeld bij de opties met flexibel beleid omdat het gepubliceerde beleid van xAI volwassen thema's toestaat in duidelijk fictieve settings voor volwassen gebruikers. Claude Sonnet 4.6 schrijft het sterkste proza in de catalogus en past bij SFW creatief schrijven; het beleid van Anthropic verbiedt expliciete content, dus houd het bij verhaalgedreven, niet-expliciete chats. Alle catalogusprijzen hieronder zijn betaal-per-gebruik zonder abonnement. Wereldwijde modellen zijn geprijsd 20% onder de officiële tarieven en Chinese modellen onder de officiële prijzen, en een eerste storting verdubbelt je startsaldo.

Veelgestelde vragen