API-Dokumentation

Authentifizierung und Base URL

Die API erfordert einen einzelnen API-Schlüssel zur Authentifizierung. Sie erhalten diesen Schlüssel sofort nach der Anmeldung mit Google oder einer E-Mail-Adresse. Übergeben Sie ihn im Authorization Header als Bearer-Token. Die Basis-URL ist https://api.topuncensored.com/v1. Diese URL funktioniert mit jedem OpenAI-kompatiblen SDK oder Client-Bibliothek.

• Verwenden Sie den Header: Authorization: Bearer YOUR_API_KEY
• Legen Sie die Base-URL Ihres Clients auf den angegebenen Endpunkt fest.

Diese Konfiguration stellt sicher, dass Sie Bibliotheken austauschen können, ohne Ihre Kernlogik zu ändern.

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-Vervollständigungs-Endpunkt

Senden Sie Textprompts an das /v1/chat/completions Endpunkt. Die Modell-ID lautet uncensored. Dieser Endpunkt verarbeitet standardmäßige Chat-Formatierungen mit Nachrichten. Er gibt Textantworten direkt zurück. Es gibt keine zusätzlichen Schichten oder Wrapper. Sie steuern das Context-Window von 100.000 Tokens. Anfragen unter 8 MB funktionieren zuverlässig. Nutzen Sie dies für direkte Textgenerierung.

Strukturieren Sie Ihre Anfrage mit einem System-Prompt und einer User-Nachricht. Das Modell antwortet ohne Filterung rechtmäßiger Erwachseneninhalte. Fehler wie fehlende Keys geben 401 zurück. Guthaben verbraucht? Sie erhalten einen 402-Fehler. Dies sind klare Signale.

Streaming-Antworten

Aktivieren Sie Streaming, indem Sie stream: true. Sie erhalten Textchunks, während sie generiert werden. Dies reduziert die wahrgenommene Latenz für lange Ausgaben. Der letzte Chunk enthält Token-Nutzungsdaten. Verwenden Sie dies für Echtzeitanzeigen oder progressives Rendern. Dies ist effizient für anwendungsintensive Szenarien.

Analysieren Sie jeden Chunk, um Ihre endgültige Antwort zu erstellen. Diese Methode verarbeitet große Ausgaben problemlos. Die API unterstützt standardmäßige Server-Sent Events. Dies ist der empfohlene Ansatz für 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-Aufruf und JSON-Modus

Nutze Function Calling für strukturierte Interaktionen. Definiere Tools in deiner Anfrage. Das Modell gibt strukturierte Argumente zurück. Setze response_format zu {"type": "json_object"} für strikte JSON-Ausgabe. Dies gewährleistet vorhersehbare Datenformate. Kombinieren Sie diese Funktionen für robuste Integrationen. Sie erhalten präzise Kontrolle über die Ausgabestruktur.

Tool-Aufruf funktioniert mit dem Standard-OpenAI-Schema. JSON-Modus erzwingt gültiges JSON. Verwenden Sie dies für API-Integrationen oder Datenerfassung. Diese Flexibilität unterstützt komplexe 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);

Parameter und Limits

Anpassen temperature, top_p, und stop Sequenzen. Set max_tokens auf 16.000. Standard ist 2.048, wenn weggelassen. Steuern Sie Wiederholungen mit presence_penalty und frequency_penalty. Verwenden Sie seed für deterministische Ausgaben. Diese Parameter feintunen die Generierungsqualität. Sie haben die volle Kontrolle über den Ausgabestil.

Die Ratenbegrenzung beträgt 300 Anfragen pro Minute. Gleichzeitige Anfragen sind auf 8 begrenzt. Diese Grenzen gewährleisten stabile Leistung. Überwachen Sie Ihre Nutzung über das Dashboard. Passen Sie Parameter an, um sie für Ihren spezifischen Anwendungsfall zu optimieren.

Fehler und Kontextfenster

Behandle Fehler korrekt. 401 bedeutet ungültiger Schlüssel. 402 zeigt unzureichendes Guthaben an. 429 signalisiert Limits. Das Kontextfenster beträgt insgesamt 100.000 Tokens. Die Ausgabe ist auf 16.000 Tokens begrenzt. Verwalte deine Tokens weise. Fehler verbrauchen kein Guthaben. Dies spart Geld beim Debuggen. Verwende den letzten Chunk für Nutzungsstatistiken.

Verfolgen Sie Ihre Token-Nutzung. Vermeiden Sie das Erreichen von Ratenlimits. Wiederholen Sie mit exponentiellem Backoff. Dies gewährleistet einen zuverlässigen Betrieb. Die API ist für Robustheit ausgelegt. Behandeln Sie Fehler als Teil des normalen Ablaufs.

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)