NL ▾
API-sleutel aanvragen

Uncensored Endpoint: Basis-URL, model-ID en limieten

Een ongecensureerd endpoint hier is een gehoste, OpenAI-compatibele tekst-API die zonder inhoudsweigeringen antwoordt voor wettelijk volwassen gebruik. Deze pagina geeft de exacte basis-URL, model-ID, methoden, limieten en foutcodes die je nodig hebt voordat je code schrijft.

Bijgewerkt

Belangrijkste punten

  1. De basis-URL is https://api.uncensoredendpoint.com/v1 en de enige model-ID is uncensored.
  2. Er zijn twee methoden beschikbaar: POST /v1/chat/completions en GET /v1/models.
  3. Het contextvenster is 100.000 tokens, prompt en antwoord samen.
  4. Een standaard sleutel staat 8 gelijktijdige verzoeken en 300 verzoeken per minuut toe.
Isometrische illustratie van een datapijp die een laptop verbindt met een API-server

De verbindingsinstellingen in één oogopslag

Als je alleen de waarden nodig hebt, staan ze hier. Alles anders op deze pagina legt uit hoe ze zich in de praktijk gedragen.

InstellingWaarde
Basis-URLhttps://api.uncensoredendpoint.com/v1
Model-IDuncensored
Auth-headerAuthorization: Bearer YOUR_KEY
EndpointsPOST /v1/chat/completions, GET /v1/models
Contextvenster100.000 tokens, prompt plus voltooiing
Maximale verzoekgrootte8 MB
Volledige keylimieten8 gelijktijdige verzoeken, 300 verzoeken per minuut
Limieten van de proefsleutel2 gelijktijdige verzoeken, 60 verzoeken per minuut
Prijs$0,15 per 1M input tokens, $0,50 per 1M output tokens

De service gebruikt hetzelfde dataformaat als de OpenAI chat-completions API. Als een tool je een aangepaste basis-URL en een API-sleutel laat invoeren, kan deze ermee communiceren. Je krijgt een sleutel op de API-sleutelpagina, en de documentatie bevat dezelfde verwijzing in kortere vorm.

Wat elke methode doet

Er zijn slechts twee routes, wat de interface klein houdt.

  • GET /v1/models retourneert de modellenlijst. Je ziet één item, uncensored. Veel clients gebruiken deze route om een modeldropdown te vullen, dus het is ook een snelle manier om te bevestigen dat je sleutel en URL correct zijn.
  • POST /v1/chat/completions is het werkpaard. Het neemt een lijst met berichten en retourneert een voltooiing, zowel als één JSON-respons of als een server-sent event stream.

De oude tekst-completions route, de responses route, embeddings, beeldroutes en audioroutes maken niet deel uit van het product. Als een bibliotheek een van die routes probeert, verwacht dan een fout en schakel de bibliotheek naar de chatmodus.

Een snelle controle vanaf een terminal:

curl https://api.uncensoredendpoint.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Een JSON-lijst met uncensored betekent dat de sleutel werkt. Een HTTP 401 betekent dat de sleutel ontbreekt, verkeerd is getypt of een spatie of newline bevat, wat de meest voorkomende oorzaak is als de sleutel uit een shell-variabele komt.

Je eerste verzoek in curl, Python en Node

Alle drie de voorbeelden sturen hetzelfde: één systeembericht, één gebruikersbericht, een lage temperatuur. Vervang YOUR_KEY of stel de omgevingsvariabele API_KEY in.

curl https://api.uncensoredendpoint.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Explain what a context window is in two sentences."}
    ],
    "temperature": 0.7
  }'

Met de officiële Python SDK geef je slechts twee extra argumenten aan de client door:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredendpoint.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise assistant."},
        {"role": "user", "content": "Explain what a context window is in two sentences."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

En in Node met dezelfde SDK:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.uncensoredendpoint.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "system", content: "You are a concise assistant." },
    { role: "user", content: "Explain what a context window is in two sentences." },
  ],
});
console.log(resp.choices[0].message.content);

De respons bevat een usage object met tellingen van prompt- en completion-tokens. Houd dit in de gaten: deze twee getallen zijn waar je voor wordt gefactureerd. De responsheaders bevatten ook X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests en X-RateLimit-Limit-Concurrency. Log de request-id bij elke aanroep, omdat dit het eerste is wat support vraagt als er iets niet klopt.

Streaming, tool calling en JSON-modus

Drie functies dekken de meeste echte toepassingen, en alle drie volgen de OpenAI-formaten die je al kent.

Streaming

Stel stream: true in en lees server-sent events. Gebruik wordt aan het einde van de stream gerapporteerd, dus je kunt tokens tellen zonder een tweede verzoek. Eén detail is belangrijk voor capaciteitsplanning: een gestreamd verzoek houdt zijn concurrency slot vast tot de stream klaar is. Een trage client die een lang antwoord in druppels leest, houdt een slot de hele tijd bezet.

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a four-line poem about rain."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Function calling

Geef tools en optioneel tool_choice door. Als het model besluit een functie aan te roepen, krijg je tool_calls in het antwoord (ook gestreamd, als je streamt). Je voert de functie zelf uit en stuurt het resultaat terug als een bericht met role: "tool". Het model is een enkel open-weight model, dus test je toolschemas met een paar realistische prompts en houd parameterbeschrijvingen kort en letterlijk.

JSON-modus

Stuur response_format: {"type":"json_object"} om om geldige JSON-output te vragen. Zeg ook in de prompt dat je JSON wilt en beschrijf de velden die je verwacht. Parse toch defensief en probeer het één keer opnieuw bij een parse-fout in plaats van de output blindelings te vertrouwen.

Samplingcontroles worden doorgegeven: temperature, top_p, stop, seed en de frequentie- en aanwezigheidsstraffen.

Het 100.000-token venster in de praktijk

Het contextvenster is 100.000 tokens, en dat getal dekt zowel de prompt als de voltooiing samen. De voltooiing kan alles gebruiken wat de prompt overlaat, en max_tokens is optioneel. Als je 90.000 tokens prompt stuurt, blijven er maximaal ongeveer 10.000 over voor het antwoord.

Een ruwe vuistregel voor Engelse tekst is dat één token iets minder is dan één woord, dus 100.000 tokens komt neer op ongeveer 70.000 woorden. Dat is genoeg voor een lang manuscript, een groot deel van een codebasis, of meerdere uren chatgeschiedenis. Drie gewoontes houden dit bruikbaar:

  • Knip de geschiedenis opzettelijk af. Chatclients sturen elk gesprek opnieuw volledig door, dus kosten en latentie groeien mee. Bewaar de systeemprompt, een samenvatting van eerdere gesprekken en de laatste paar berichten.
  • Stel max_tokens in als de outputgrootte er toe doet. Het is optioneel, maar een limiet beschermt je tegen een uit de hand gelopen antwoord op een lange prompt.
  • Let op de 8 MB body-limiet. Deze is apart van het tokenvenster. Platte tekst bereikt zelden 8 MB, maar base64-blobs die in een prompt worden geplakt, wel.

Omdat facturatie per token is, kost een verzoek met een volledig venster echt geld in vergelijking met een kort verzoek. De prijzenpagina heeft de tarieven, en je kunt elk verzoek berekenen als invoertokens keer $0,15 plus outputtokens keer $0,50, elk gedeeld door één miljoen.

Rate limits en de 429-familie

Een standaard sleutel staat 8 gelijktijdige verzoeken en 300 verzoeken per minuut toe. De proefaccount-sleutel is strakker: 2 gelijktijdig en 60 per minuut. Als je een grens overschrijdt, antwoordt de API met HTTP 429, en de foutcode vertelt je welke grens:

Error codeBetekenisWat te doen
rate_limitedTe veel verzoeken per minuutVertraag; spreid aanroepen over de minuut
concurrencyTe veel gelijktijdige verzoekenWacht in je eigen code; beperk gelijktijdige workers tot 8 (2 tijdens proefversie)
429 met Retry-After: 5Tijdelijke overbelastingWacht 5 seconden en probeer het opnieuw

De eenvoudigste verdediging is een semaphore in je eigen code, grootte aangepast aan je sleutel. In Python met asyncio, asyncio.Semaphore(8) rond elke aanroep verwijdert de concurrency fout helemaal. Voeg een retry toe die de Retry-After header respecteert en terugvalt op een korte exponentiële vertraging als de header ontbreekt. Onthoud dat streams een slot vasthouden voor hun volledige lengte, dus een batch van acht lange streams blokkeert een negende verzoek, zelfs als het aantal verzoeken per minuut laag is.

Mislukte of geweigerde verzoeken worden niet gefactureerd, dus een retry-loop kost je niets voor de pogingen die faalden.

Wat het model is, en wat het niet is

De service draait één open-weight model, gehost door een onafhankelijke provider en afgestemd om zonder inhoudsweigeringen te antwoorden voor wettelijk volwassen gebruik. Het is niet de officiële API van een grote leverancier, en het is geen router die tussen leveranciers kiest. Er is één model, uncensored, dus er is niets om tussen te kiezen en geen prijsniveau om te vergelijken.

De limieten zijn duidelijk. Tekst gaat erin en tekst komt eruit. Er is geen beeld-, audio- of videogeneratie, geen embeddings en geen fine-tuning. De enige vaste inhoudsregel is dat seksuele inhoud met minderjarigen nooit is toegestaan. Prompts worden niet gebruikt voor training.

Dit kader helpt bij het plannen van een project. Fictie- en roleplaytools voor volwassenen, companion-apps, onderzoek naar modelgedrag en tools die botte of gevoelige tekst verwerken zonder dat het model terugdeinst, zijn allemaal natuurlijke toepassingen. Als je embeddings voor zoekopdrachten nodig hebt, heb je een aparte provider daarvoor nodig en kun je dit endpoint nog steeds gebruiken voor generatie.

Voordat je naar productie gaat

Een werkende demo is vijf minuten werk. Een betrouwbare service kost iets meer. Begin met de proefversie: nieuwe gebruikers kunnen na het inloggen met één klik op de sleutelpagina $0,50 aan tegoed claimen, één keer per persoon, geldig voor 7 dagen en zonder betaling nodig. Inloggen kan via Google of met e-mail en wachtwoord. Dat is genoeg voor honderden korte testverzoeken om je integratie te controleren.

Wanneer je overschakelt naar echt verkeer, laad je op met een willekeurig heel bedrag van $20 tot $500. Betaling is met crypto (USDT on TRC20, USDC on Base). Tegoed vervalt nooit en er is geen abonnement, dus een saldo blijft gewoon staan totdat je het uitgeeft. De bonus is 5% vanaf $50, 10% vanaf $100 en 15% vanaf $200.

Werk vervolgens een korte lijst af: sla de sleutel op in een omgevingsvariabele of een secrets manager, nooit in clientcode; log X-Request-Id; houd X-Balance-USD in de gaten zodat je kunt waarschuwen voordat het saldo op raakt; beperk het aantal gelijktijdige workers; en behandel 429 met een vertraging in plaats van een strakke lus. De productiechecklist voor API-sleutels gaat dieper in op het beheer van sleutels, en de documentatie bevat de parameterverwijzing.

Vragen en antwoorden

Heb ik een speciale SDK nodig?

Nee. Elke OpenAI SDK of client werkt. Pas de basis-URL en de sleutel aan, stel het model in op uncensored en de rest van je code blijft hetzelfde.

Kan het afbeeldingen of embeddings genereren?

Nee. De API is alleen tekst. Er is geen beeld-, audio- of videogeneratie, geen embeddings en geen fine-tuning.

Wat gebeurt er als ik een rate limit raak?

Je krijgt HTTP 429. De foutcode is rate_limited als je de verzoeken per minuut overschrijdt en concurrency als er te veel gelijktijdige verzoeken lopen. Wacht een moment en probeer het opnieuw.

Is er een harde inhoudsregel?

Ja. Seksuele inhoud met minderjarigen is nooit toegestaan. Alles anders beantwoordt het model zonder weigeringen, voor wettelijk volwassen gebruik.

Je sleutel is nog maar één formulier verwijderd

Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.

API-sleutel ophalenDocumentatie lezen