Schnellstart: Integration in wenigen Minuten

1. Installieren Sie Ihr SDK

Installieren Sie zunächst die offizielle Bibliothek für Ihre Sprache. Die meisten Entwickler bevorzugen das Standardpaket, da es der Schnittstelle entspricht, die sie bereits kennen. Führen Sie pip install openai für Python oder npm install openai für Node.js. Sie benötigen nur ein SDK, um alle Anfragen zu bearbeiten.

2. Ihre Basis-URL festlegen

Konfigurieren Sie Ihren Client so, dass er auf unseren spezifischen Endpunkt zeigt. Sie müssen die Standard-Base-URL überschreiben, um den Verkehr korrekt zu routen. Verwenden https://api.unsencoredai.com/v1 als Ihre Basis-URL. Übergeben Sie Ihren API-Schlüssel im Authorization header. Dieses Setup funktioniert mit jedem Standard-OpenAI-kompatiblen Client.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

3. Erste Anfrage senden

Senden Sie eine Standard-Chat-Vervollständigungsanfrage, um Text zu generieren. Die Modell-ID ist uncensored. Sie können System-Prompts senden, um das Verhalten zu steuern. Die API gibt eine direkte Textantwort zurück. Verwenden Sie den folgenden curl-Befehl, um die Konnektivität sofort zu testen. Überprüfen Sie Ihre Antwort auf das choices array.

Copycurl https://api.unsencoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the version number"}]
  }'

4. Streaming-Antworten verarbeiten

Aktivieren Sie Streaming für geringere Latenz und Echtzeitausgabe. Legen Sie stream: true in Ihrer Anfrage. Die API sendet Chunks über Server-Sent Events. Sie können jedes Token verarbeiten, sobald es eingeht. Dies ist ideal für Chat-Schnittstellen oder Rollenspiel-Szenarien. Der letzte Chunk enthält Nutzungsstatistiken.

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)

5. Parameter konfigurieren

Anpassen temperature, top_p, und stop Sequenzen. Diese Einstellungen beeinflussen Kreativität und Ausgabelänge. Sie können auch response_format für JSON-Ausgaben. Der Kontextfenster unterstützt insgesamt 100.000 Tokens. Maximaler Output sind 16.000 Tokens pro Anfrage. Passen Sie diese Einstellungen für Ihren spezifischen Anwendungsfall an.

6. Limits, Fehler und Kontext

Behandle Fehler korrekt unter Verwendung standardisierter HTTP-Statuscodes. Ein 401-Fehler bedeutet, dass dein API-Schlüssel ungültig ist. Ein 402-Fehler zeigt unzureichendes vorausbezahltes Guthaben an. Ein 429-Fehler signalisiert, dass du das Limit von 300 Anfragen pro Minute erreicht hast. Dein Kontextfenster beträgt 100.000 Tokens. Anfragen über 8 MB können fehlschlagen. Rückerstattungen werden nicht für Guthaben ausgegeben, Fehler sind jedoch kostenlos.