Schnellstart: Integrieren Sie die Uncensored API

Voraussetzungen und SDK-Installation

Die API erfordert einen gültigen API-Schlüssel und ein modernes SDK. Installieren Sie die Bibliothek für Ihre bevorzugte Sprache über pip oder npm. Wir unterstützen Standard-OpenAI-Clientbibliotheken, die Authentifizierung und JSON-Parsing automatisch übernehmen.

Stellen Sie sicher, dass Python 3.8+ oder Node.js 18+ installiert sind. Die SDKs verwalten Connection-Pooling und Retry-Logik für Sie. Dies reduziert den Boilerplate-Code erheblich.

Copyfrom openai import OpenAI

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

Konfigurieren der Basis-URL und des API-Schlüssels

Richten Sie Ihren Client auf unseren spezifischen Endpunkt. Verwenden Sie die in Ihrem Dashboard angegebene Basis-URL. Übergeben Sie Ihren API-Schlüssel im Authorization-Header. Dies stellt sicher, dass Anfragen direkt die uncensored-Infrastruktur erreichen.

Verwenden Sie nicht die Standard-OpenAI-Basis-URL. Ihr Schlüssel schlägt fehl, wenn er falsch geroutet wird. Legen Sie die Basis-URL in Ihrem SDK-Konfigurationsobjekt fest, bevor Sie Daten senden.

Copycurl https://api.ablatedmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Send me the monthly server uptime report"}]
  }'

Ihre erste Chat Completion-Anfrage senden

Sende eine POST-Anfrage an /v1/chat/completions. Füge deine Model-ID und ein messages-Array ein. Das Modell antwortet sofort mit Textinhalt. Keine komplexe Routing-Logik ist erforderlich.

Halten Sie die Payload einfach. Beginnen Sie mit einem einzelnen System-Prompt und einer einzelnen Benutzer-Nachricht. Überprüfen Sie, ob die Antwortstruktur dem OpenAI-Standard entspricht. Dies bestätigt, dass Ihre Integration korrekt funktioniert.

Copyimport OpenAI from "openai";

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

Streaming-Antworten und Tool-Nutzung handhaben

Aktivieren Sie das Streaming, indem Sie stream auf true setzen. Die API gibt Chunks über Server-Sent Events zurück. Jeder Chunk enthält teilweise Text- oder Token-Nutzungsdaten. Aggregieren Sie diese Chunks, um Echtzeit-Ausgaben anzuzeigen.

Die Werkzeugnutzung wird für Function Calling unterstützt. Definieren Sie Ihre Werkzeuge in der Anfrage. Das Modell gibt Werkzeugaufrufe anstelle von reinem Text zurück, wenn dies angemessen ist. Analysieren Sie die Werkzeugaufrufe, um Ihre benutzerdefinierte Logik auszuführen.

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)

Verständnis der Token-Limits und des Kontextfensters

Das Kontextfenster unterstützt insgesamt 100.000 Tokens. Dies umfasst sowohl Eingabe- als auch Ausgabetokens. Legen Sie max_tokens fest, um die Antwortlänge zu begrenzen. Die maximale Standardausgabe beträgt 2.048 Tokens, wenn nicht angegeben.

Tokenverbrauch im letzten Streaming-Chunk überwachen. Fehler verbrauchen kein Guthaben. Dies ermöglicht sicheres Experimentieren ohne finanzielles Risiko. Planen Sie Ihre Prompt-Struktur so, dass sie innerhalb des Limits bleibt.

Fehlerbehebung bei häufigen Fehlern

Prüfen Sie zuerst Ihren API-Schlüssel. Ein 401-Fehler zeigt einen ungültigen oder abgelaufenen Schlüssel an. Ein 402-Fehler bedeutet, dass Ihr prepaid-Guthaben erschöpft ist. Laden Sie über Krypto auf, um fortzufahren.

Ein 429-Fehler signalisiert die Begrenzung der Rate. Sie sind auf 300 Anfragen pro Minute begrenzt. Reduzieren Sie Ihre Parallelität oder warten Sie vor dem Wiederholen. Das 8-MB-Körperlimit löst auch 400-Fehler aus, wenn es überschritten wird.