API Dokumentation

Autentificering og Base URL

API'en kræver en enkelt API-nøgle til autentificering. Du modtager denne nøgle øjeblikkeligt efter tilmelding med Google eller en e-mail-adresse. Send den i Authorization header som en Bearer-token. Base-URL'en er https://api.topuncensored.com/v1. Denne URL fungerer med ethvert OpenAI-kompatibelt SDK eller klientbibliotek.

• Brug headeren: Authorization: Bearer YOUR_API_KEY
• Indstil din klients base URL til det angivne endpoint.

Denne opsætning sikrer, at du kan skifte biblioteker uden at ændre din kerne-logik.

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

Send tekstprompts til /v1/chat/completions endpoint. Model-ID er uncensored. Dette endpoint håndterer standard chat-formatering med meddelelser. Det returnerer tekstsvare direkte. Der er ingen ekstra lag eller wrappers. Du kontrollerer kontekstvinduet på 100.000 tokens. Anmodninger under 8 MB virker pålideligt. Brug dette til direkte tekstgenerering.

Strukturer din anmodning med et systemprompt og en brugermeddelelse. Modellen svarer uden at filtrere lovligt voksenindhold. Fejl som manglende nøgler returnerer 401. Løb tør for kredit? Du får en 402-fejl. Disse er klare signaler.

Streaming-svar

Aktivér streaming ved at indstille stream: true. Du modtager tekstchunks, mens de genereres. Dette reducerer den opfattede latens for lange output. Den sidste chunk inkluderer tokenbrugsdata. Brug dette til visning i realtid eller progressiv rendering. Det er effektivt til applikationer med højt volumen.

Parser hver chunk for at opbygge dit endelige svar. Denne metode håndterer store outputs korrekt. API'et understøtter standard Server-Sent Events. Dette er den anbefalede tilgang til interaktive 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 and JSON Mode

Brug funktionssamtale til strukturerede interaktioner. Definer værktøjer i din anmodning. Modellen returnerer strukturerede argumenter. Indstil response_format til {"type": "json_object"} for streng JSON-output. Dette sikrer forudsigelige dataformater. Kombiner disse funktioner for robuste integrationer. Du får præcis kontrol over outputstrukturen.

Tool calling fungerer med det standard OpenAI-skema. JSON-mode tvinger gyldig JSON. Brug disse til API-integrationer eller dataudtræk. Denne fleksibilitet understøtter komplekse arbejdsgange.

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 and Limits

Juster temperature, top_p, og stop sekvenser. Indstil max_tokens til 16.000. Standard er 2.048, hvis udeladt. Kontroller gentagelse med presence_penalty og frequency_penalty. Brug seed til deterministiske output. Disse parametre finjusterer genereringskvaliteten. Du har fuld kontrol over output-stilen.

Ratebegrænsningen er 300 requests i minuttet. Samtidige requests maksimeres til 8. Disse grænser sikrer stabil ydeevne. Overvåg din brug via dashboardet. Juster parametre for at optimere til din specifikke brugssag.

Fejl og kontekstvindue

Håndter fejl elegant. 401 betyder ugyldig nøgle. 402 indikerer utilstrækkelig kredit. 429 signalerer hastighedsgrænser. Kontekstvinduet er 100.000 tokens i alt. Output maksimeres til 16.000 tokens. Håndtér dine tokens klogt. Fejl forbruger ikke kredit. Dette sparer penge under fejlfinding. Brug den sidste chunk til brugssatistik.

Spor dit tokenforbrug. Undgå at ramme rategrænser. Genforsøg med eksponentiel backoff. Dette sikrer pålidelig drift. API'et er designet til robusthed. Håndter fejl som en del af normal 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)