Uncensored API Veelgestelde vragen

De basis

Wat is Uncensored API in één zin?

Het is een betaald, tekst-only chat-completions endpoint dat één model bedient, id uncensored, en wettelijke volwassen inhoud, fictie of controversiële onderwerpen niet weigert.

Welke URL moet ik aanroepen?

Gebruik https://api.uncensoredapis.com/v1 als base URL. Chat-verzoeken gaan naar POST /v1/chat/completions en de modellijst staat bij GET /v1/models. Elk ander pad geeft een 404.

Moet ik een nieuwe SDK leren?

Nee. De structuur van het verzoek en het antwoord volgt de gangbare chatcompletiesconventie, dus de officiële Python- en Node-pakketten werken zodra je de basis-URL en de sleutel aanpast. Gewone curl werkt ook, zoals de documentatie laat zien.

Kan ik het eerst uitproberen voordat ik betaal?

Ja. Een nieuw account krijgt $0,50 proeftegoed, geldig voor 7 dagen, en er worden geen betaalgegevens gevraagd bij het aanmelden. Registreer met een e-mailadres en wachtwoord op de key page en de sleutel verschijnt direct.

Kan ik kiezen uit meerdere modellen?

Nee. Er is precies één model en de id is uncensored. Een verzoek naar de models route geeft die enkele entry terug, dus er is niets te selecteren of tussen te schakelen.

Voor wie is de service bedoeld?

Ontwikkelaars die producten bouwen voor volwassenen, inclusief fictie-tools, roleplay-apps en research-assistenten. Jij bent zelf verantwoordelijk voor je eigen leeftijdscontroles en inhoudsregels in wat je bovenop levert.

Sleutels en toegang

Hoeveel sleutels krijgt een account?

Eén. Als je een nieuwe waarde nodig hebt, genereer deze dan opnieuw vanuit het account; de vorige sleutel werkt op hetzelfde moment niet meer, dus implementeer de vervanging direct.

Waar moet de sleutel staan?

Bewaar het in een environment variable of een secret manager op een server die jij beheert. Browser-JavaScript en mobiele binaries kunnen worden geïnspecteerd, dus routeer clientverkeer via je eigen backend in plaats van de sleutel te embedden.

Hoe wordt de sleutel verstuurd?

In een Authorization: Bearer header bij elk verzoek. Een ontbrekende of verkeerde waarde retourneert 401 met een JSON error object.

Ik wil een ongecensureerde API-sleutel voor een team. Kunnen we er één delen?

Dat kan, maar elke process deelt dezelfde limiet van 300 verzoeken per minuut en hetzelfde saldo. Zet een kleine gateway voor de sleutel en geef elke teamgenoot toegang tot de gateway in plaats van de sleutel zelf.

Limieten en prijzen

Hoe groot kan een prompt zijn?

Het contextvenster is 100.000 tokens, gedeeld door prompt en completion. De body van een enkel verzoek mag niet groter zijn dan 8 MB. Een verzoek waarvan prompt plus max_tokens het venster zou overschrijden, wordt afgewezen met een 400.

Hoe lang mag een antwoord zijn?

De standaard is 2048 tokens. Je kunt max_tokens verhogen tot maximaal 32.000 per verzoek. Als een antwoord stopt vanwege de cap, leest finish_reason length.

Wat kost het?

Invoer tokens kosten $0,25 per miljoen en uitvoer tokens kosten $1,00 per miljoen. Saldo is prepaid, er is geen abonnement en het saldo vervalt nooit. Zie de pricing page voor de tabel.

Kun je een snelle schatting geven?

Neem aan dat een chat turn 1.500 prompt tokens en 300 completion tokens heeft, puur als illustratie. Dat is $0,000375 voor invoer plus $0,0003 voor uitvoer, of ongeveer $0,000675 per turn, dus $1 koopt ongeveer 1.480 zulke turns.

Wat gebeurt er als ik te veel verzoeken verstuur?

Elke sleutel mag 300 verzoeken per minuut doen. Daarboven krijg je een 429, en de juiste reactie is om langzamer te gaan en opnieuw te proberen met een vertraging.

Integratievragen

Welke sampling parameters kan ik instellen?

Standaardwaarden zoals temperature, top_p en stop worden doorgegeven aan de generatie. Stel ze in in de request body, precies zoals je dat elders doet.

Onthoudt de API eerdere draaien voor mij?

Nee. Elk verzoek is onafhankelijk, dus je stuurt de conversatie elke keer opnieuw in messages. Knip de oudste draaien weg als het totaal de contextvenster van 100.000 tokens nadert.

Kan ik tokens streamen naar een browser?

Ja, stuur stream: true en lees de server-sent events. Doe dit vanuit je backend en relay de tekst naar de pagina, zodat de sleutel nooit de client bereikt.

Wordt een system message ondersteund?

Ja. Plaats een bericht met de system role als eerste in de array om de toon, het formaat en de grenzen van de conversatie in te stellen.

Wat moet ik eerst controleren als de output afgekapt lijkt?

Lees finish_reason. Een waarde van length betekent dat de limiet is bereikt, dus verhoog max_tokens of maak de prompt korter. De reference somt alle waarden op.

Saldo en facturatie

Hoe voeg ik geld toe?

Laad je prepaid tegoed op via je account. Er is niets om aan te abonneren, en ongebruikt saldo blijft beschikbaar omdat het nooit verloopt.

Wat gebeurt er als het gratis proeftegoed op is?

Het gratis proeftegoed is 7 dagen geldig. Als het is opgebruikt of verlopen, retourneren verzoeken 402 met de code no_credit totdat je het saldo opwaardeert.

Kan ik zien wat een verzoek kost?

Elke response bevat een usage blok met prompt, completion en totale tokens. Vermenigvuldig met de tarieven per miljoen tokens om de kosten te berekenen, en houd je eigen administratie bij als je een ledger wilt.

Zijn mislukte verzoeken gratis om opnieuw te proberen?

Opnieuw proberen is toegestaan, maar houd het beperkt. Gebruik een korte backoff voor 429 en 503 en loop nooit door op 400, 401, 402 of 403, omdat deze zichzelf niet oplossen. De errors playbook bevat een kant-en-klaar beleid.

Inhoud en gedrag

Wat zal het model niet doen?

Wettelijk volwassen inhoud wordt niet geweigerd, evenmin als fictie of controversiële onderwerpen. De uitzondering is seksuele inhoud met minderjarigen, die elke keer wordt geblokkeerd met een 403, ook in verhalen en roleplay. De dienst is voor volwassenen van 18 jaar en ouder.

Worden mijn prompts gebruikt om een model te trainen?

Nee. Prompts worden niet gebruikt voor training.

Hoe verschilt dit van routing via een aggregator?

Een aggregator stuurt je door naar veel modellen, elk met eigen regels. Deze dienst is één model achter één beleid. De uncensored OpenRouter guide gaat die vergelijking uitgebreid door.

Kan het afbeeldingen zien of embeddings maken?

Nee. Het verwerkt alleen tekst, zonder embeddings, afbeeldingen, audio, video of fine-tuning.

Probleemoplossing

Ik krijg 402 met no_credit. Wat nu?

Je saldo is op of het gratis proeftegoed is verlopen. Laad het prepaid tegoed op en stuur het verzoek opnieuw.

Een verzoek retourneert 503 upstream_busy.

Het is tijdelijk. Wacht een paar seconden en probeer opnieuw, met een groeiende vertraging en wat randomisatie als je veel workers draait.

Mijn stream eindigt en ik kan het token count niet vinden.

Met streaming aan wordt een laatste chunk met usage automatisch toegevoegd, direct voor data: [DONE]. De choices lijst is leeg, dus controleer daarop voordat je indexeert.

Werken tools en function calling?

Ja, in het standaard formaat: stuur een tools array en kijk naar tool_calls in de reply.