API-dokumentation

Autentisering och bas-URL

API:et kräver en giltig API-nyckel för autentisering. Du får denna nyckel omedelbart efter att du registrerat dig med Google eller en epostadress. Skicka den i Authorization header som ett Bearer-token. Bas-URL:en är https://api.topuncensored.com/v1. Denna URL fungerar med vilket OpenAI-kompatibelt SDK eller klientbibliotek som helst.

• Använd huvudet: Authorization: Bearer YOUR_API_KEY
• Ställ in din klients bas-URL till den angivna slutpunkten.

Denna konfiguration säkerställer att du kan byta bibliotek utan att ändra din kärnlogik.

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."}]
  }'

Slutpunkt för chattkomplettering

Skicka textprompter till /v1/chat/completions endpoint. Modell-ID:t är uncensored. Denna slutpunkt hanterar standard chattformatering med meddelanden. Den returnerar textsvar direkt. Det finns inga extra lager eller omslag. Du kontrollerar kontextrutan på 100 000 tokens. Begäranden under 8 MB fungerar tillförlitligt. Använd detta för direkt textgenerering.

Strukturera din begäran med en systemprompt och ett användarmeddelande. Modellen svarar utan att filtrera lagligt vuxet innehåll. Fel som saknade nycklar returnerar 401. Slutade krediter? Du får ett 402-fel. Dessa är tydliga signaler.

Strömningsresponser

Aktivera strömning genom att ställa in stream: true. Du får textbitar när de genereras. Detta minskar den upplevda latensen för långa utdata. Den sista biten innehåller tokenanvändningsdata. Använd detta för visningar i realtid eller progressiv rendering. Det är effektivt för applikationer med hög volym.

Analysera varje chunk för att bygga ditt slutliga svar. Denna metod hanterar stora utmatningar smidigt. API:t stöder standard Server-Sent Events. Detta är den rekommenderade metoden för interaktiva appar.

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)

Verktygsanrop och JSON-läge

Använd funktionsanrop för strukturerade interaktioner. Definiera verktyg i din begäran. Modellen returnerar strukturerade argument. Ställ in response_format för {"type": "json_object"} för strikt JSON-utdata. Detta säkerställer förutsägbara dataformat. Kombinera dessa funktioner för robusta integrationer. Du får exakt kontroll över utdatastrukturen.

Verktygsanrop fungerar med standard OpenAI-schemat. JSON-läget tvingar giltig JSON. Använd dessa för API-integrationer eller datautvinning. Denna flexibilitet stöder komplexa arbetsflöden.

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

Justera temperature, top_p, och stop sekvenser. Ställ in max_tokens till 16 000. Standard är 2 048 om det utelämnas. Kontrollera repetition med presence_penalty och frequency_penalty. Använd seed för deterministiska utdata. Dessa parametrar finjusterar genereringskvaliteten. Du har full kontroll över utdata-stilen.

Rate limits är 300 förfrågningar per minut. Samtidiga förfrågningar når max 8. Dessa gränser säkerställer stabil prestanda. Övervaka din användning via dashboarden. Justera parametrar för att optimera för ditt specifika användningsfall.

Fel och kontextfönster

Hantera fel på ett elegant sätt. 401 betyder ogiltig nyckel. 402 indikerar otillräcklig kredit. 429 signalerar hastighetsbegränsningar. Kontextrutan är 100,000 tokens totalt. Utdata maxas vid 16,000 tokens. Hantera dina tokens klokt. Fel konsumerar inte kredit. Detta sparar pengar under felsökning. Använd den sista biten för användningsstatistik.

Spåra din tokenanvändning. Undvik att träffa hastighetsgränser. Försök igen med exponentiell backoff. Detta säkerställer tillförlitlig drift. API:et är utformat för robusthet. Hantera fel som en del av normal flöde.

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)