API Documentatie

Authenticatie en basis-URL

De API vereist een enkele API-sleutel voor authenticatie. Je ontvangt deze sleutel onmiddellijk na het aanmelden met Google of een e-mailadres. Geef deze door in de Authorization header als een Bearer-token. De basis-URL is https://api.topuncensored.com/v1. Deze URL werkt met elke OpenAI-compatible SDK of clientbibliotheek.

• Gebruik de header: Authorization: Bearer YOUR_API_KEY
• Stel de base URL van je client in op het opgegeven eindpunt.

Deze opstelling zorgt ervoor dat je bibliotheken kunt verwisselen zonder je kernlogica te wijzigen.

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

Chat Completions Endpoint

Stuur tekstprompts naar de /v1/chat/completions endpoint. De model-ID is uncensored. Dit endpoint verwerkt standaard chatformaten met berichten. Het retourneert tekstantwoorden direct. Er zijn geen extra lagen of wrappers. Je bepaalt het contextvenster van 100.000 tokens. Verzoeken onder 8 MB werken betrouwbaar. Gebruik dit voor directe tekstgeneratie.

Structureer je request met een system-prompt en user-message. Het model reageert zonder wettelijke volwassen inhoud te filteren. Fouten zoals ontbrekende keys retourneren 401. Credits op? Je krijgt een 402-fout. Dit zijn duidelijke signalen.

Streaming-responsen

Activeer streaming door stream: true. Je ontvangt tekstchunks terwijl ze worden gegenereerd. Dit vermindert de waargenomen latentie voor lange uitvoer. De laatste chunk bevat tokenverbruiksgegevens. Gebruik dit voor realtime weergaven of progressieve rendering. Het is efficiënt voor applicaties met hoog volume.

Parseer elke chunk om uw definitieve respons op te bouwen. Deze methode gaat soepel om met grote uitvoeren. De API ondersteunt standaard Server-Sent Events. Dit is de aanbevolen aanpak voor interactieve apps.

Copyfrom openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Tool Calling en JSON-modus

Gebruik function calling voor gestructureerde interacties. Definieer tools in uw verzoek. Het model retourneert gestructureerde argumenten. Stel response_format naar {"type": "json_object"} voor strikte JSON-output. Dit zorgt voor voorspelbare gegevensformaten. Combineer deze functies voor robuuste integraties. Je krijgt precieze controle over de outputstructuur.

Tool calling werkt met het standaard OpenAI-schema. De JSON-modus dwingt geldige JSON af. Gebruik deze voor API-integraties of gegevensextractie. Deze flexibiliteit ondersteunt complexe workflows.

Copyimport OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Parameters en limieten

Aanpassen temperature, top_p, en stop sequenties. Stel max_tokens na 16.000. Standaard is 2.048 als weggelaten. Controleer repetitie met presence_penalty en frequency_penalty. Gebruik seed voor deterministische outputs. Deze parameters verfijnen de generatiekwaliteit. Je hebt volledige controle over de outputstijl.

De rate limits zijn 300 verzoeken per minuut. Gelijktijdige verzoeken zijn beperkt tot 8. Deze limieten zorgen voor stabiele prestaties. Houd je gebruik in de gaten via het dashboard. Pas parameters aan om te optimaliseren voor je specifieke use case.

Fouten en contextvenster

Handel fouten soepel af. 401 betekent ongeldige sleutel. 402 geeft aan dat er onvoldoende credit is. 429 signaleert limieten. Het contextvenster is in totaal 100,000 tokens. Output is maximaal 16,000 tokens. Beheer je tokens verstandig. Fouten verbruiken geen credit. Dit bespaart geld tijdens het debuggen. Gebruik de laatste chunk voor gebruikstatistieken.

Volg je tokengebruik. Vermijd het raken van rate limits. Probeer opnieuw met exponentiële backoff. Dit zorgt voor betrouwbare werking. De API is ontworpen voor robuustheid. Verwerk fouten als onderdeel van de normale flow.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)