Documentatie voor Uncensored API

Authenticatie en basis-URL

Je API-sleutel verifieert elk verzoek. Gebruik de basis-URL HTTPS://api.uncensores.cc/v1 met elke standaard OpenAI SDK. De modelidentifier is "uncensored". Voer je sleutel in de Authorization-header in als Bearer-token. Je kunt een sleutel genereren via het dashboard met Google of e-mail. Elke account heeft één actieve sleutel die de vorige vervangt.

Copycurl https://api.uncensores.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top ten python libraries for data science"}]
  }'

Je moet het model-veld in elk verzoek opnemen. Het eindpunt verwacht een messages-array die je gespreksgeschiedenis bevat. Als de sleutel ontbreekt of ongeldig is, retourneert de API een 401-fout. Dit zorgt ervoor dat alleen geautoriseerde gebruikers je voorbetaalde tegoed gebruiken.

Het Chat Completions Endpoint

Verstuur POST-verzoeken aan /v1/chat/completions voor tekstgeneratie. Dit eindpunt verwerkt standaard conversatieprompten en retourneert gestructureerde tekstantwoorden. Het ondersteunt geen embeddings of image generatie. Je levert system-, user- en assistant-berichten om het model te sturen. Het model reageert met ruwe tekstinhoud binnen de choices-array.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.uncensores.cc/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)

Initialiseer de client met je basis-URL en sleutel. Definieer de messages-lijst met de gewenste rol en inhoud. Voer de chat.completions.create-methode uit. Het response-object bevat de gegenereerde tekst en gebruikstatistieken. Deze directe aanpak elimineert routingcomplexiteit voor NSFW-taken of creatief schrijven.

Streaming-responsen met SSE

Activeer streaming door stream op true in te stellen in je request. De API retourneert Server-Sent Events (SSE) terwijl tokens beschikbaar komen. Dit vermindert de waargenomen latentie voor lange uitvoer. Elke chunk bevat een gedeeltelijke delta van het antwoord. Je moet deze deltas accumuleren om de uiteindelijke tekst te reconstrueren.

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)

De laatste chunk bevat de volledige gebruikscijfers voor het verzoek. Hiermee kun je tokenverbruik in realtime bijhouden. Streaming is ideaal voor chatinterfaces waar gebruikers onmiddellijke feedback verwachten. Het werkt naadloos met het uitvoerformaat van het uncensored-model.

Function Calling en JSON-modus

De API ondersteunt function calling via de parameter tools. Definieer uw funtieschema in het verzoek en stel tool_choice in op auto of een specifieke naam. Het model retourneert functaanroepen in de respons in plaats van platte tekst. U kunt ook JSON-uitvoer afdwingen door response_format in te stellen op json_object. Dit zorgt voor voorspelbare parsing voor geautomatiseerde workflows.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensores.cc/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);

Geef de tooldefinities in de tools-array door. Het model selecteert de passende functie op basis van de input. U ontvangt de functienaam en argumenten in het antwoord. Deze functie werkt naast de standaard chat-completies zonder extra eindpunten. Gebruik het voor gestructureerde data-extractie of agent-achtig gedrag.

Parameters: Temperatuur, Top-P en Seeds

Pas de temperatuur aan om willekeurigheid te regelen. Waarden boven de 1 verhogen de creativiteit, terwijl waarden onder de 1 de outputs meer deterministisch maken. Gebruik top_p om de sampling te beperken tot het bovenste percentage van de waarschijnlijkheidsmassa. Stel een seed in voor reproduceerbare resultaten bij identieke verzoeken. Deze parameters stellen je in staat de outputstijl van het uncensored model fijn af te stemmen.

U kunt ook stop-sequenties gebruiken om de generatie te stoppen bij specifieke strings. presence_penalty en frequency_penalty helpen herhaling te verminderen. De standaard temperatuur is 1.0. Het aanpassen van deze instellingen helpt optimaliseren voor roleplay of technisch schrijven. Elk verzoek ondersteunt deze standaard OpenAI-compatibele parameters.

Tokenlimieten en contextvenster

Het contextvenster ondersteunt in totaal 100.000 tokens voor prompt en completion. U kunt maximaal 16.000 tokens per verzoek uitvoeren. Als u max_tokens weglaat, is de standaardwaarde 2.048 tokens. Deze limiet geldt voor de gecombineerde invoer en uitvoer. Verzoeken die de body-grootte van 8 MB overschrijden, zullen mislukken. De API handhaaft een rate limit van 300 verzoeken per minuut. Gelijktijdige verzoeken zijn beperkt tot 8 per sleutel. Fouten zoals 402 (geen krediet) of 429 (rate limit) bieden duidelijke feedback. Niet-gebruikt krediet vervalt nooit, zodat u alleen betaalt voor daadwerkelijk gebruik.