API-Dokumentation

Basis-URL und Authentifizierung

Die Basis-URL für alle Anfragen ist HTTPS://api.aiobliterated.com/v1. Sie benötigen einen API-Schlüssel zur Authentifizierung. Generieren Sie einen, indem Sie sich mit Google oder einer E-Mail-Adresse und Passwort auf der Seite „API-Schlüssel erhalten“ registrieren. Übergeben Sie den Schlüssel im Authorization-Header als Bearer-Token. Jede Anfrage erfordert diesen Header, um Ihr Konto zu identifizieren und die Nutzung zu verfolgen.

Copycurl https://api.aiobliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch all user tokens from database"}]
  }'

Ihre erste Anfrage

Senden Sie eine POST-Anfrage an /v1/chat/completions, um Text zu generieren. Legen Sie das Modell auf "uncensored" fest und fügen Sie Ihren System-Prompt hinzu. Die API gibt die Antwort des Modells im content-Feld zurück. Dies ist das Standardformat, das von den meisten LLM-Clients verwendet wird.

Copyfrom openai import OpenAI

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

Das Node SDK verwenden

Installieren Sie das offizielle OpenAI-SDK für Node.js. Konfigurieren Sie es mit Ihrem API-Schlüssel und der Basis-URL. Rufen Sie die Methode chat.completions.create mit Ihren Nachrichten auf. Das SDK verarbeitet Serialisierung und Streaming automatisch.

Copyimport OpenAI from "openai";

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

Aktivieren Sie das Streaming, indem Sie stream auf true setzen. Die API gibt einen Stream von Server-Sent Events zurück. Jedes Ereignis enthält einen Teil des Antwort-Chunks. Dies ermöglicht es Ihnen, Text in Echtzeit anzuzeigen, während er generiert wird, und verbessert so das Nutzererlebnis.

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)

Kontextfenster und Grenzen

Das Modell unterstützt einen Kontextfenster von 100.000 Tokens. Dies umfasst sowohl Eingabe als auch Ausgabe. Sie können eine maximale Ausgabe von 16.000 Tokens pro Anfrage festlegen. Wenn Sie max_tokens nicht angeben, beträgt der Grenzwert 2.048 Tokens. Dies gewährleistet vorhersehbare Kosten und Leistung.

Fehlerbehandlung und Limits

Überwache HTTP-Statuscodes auf Fehler. Eine 401-Antwort bedeutet, dass dein API-Schlüssel ungültig ist. Eine 402-Antwort zeigt unzureichendes Guthaben an. Eine 429-Antwort signalisiert, dass du das Limit von 300 Anfragen pro Minute überschritten hast. Behandle diese Fehler in deiner Anwendung korrekt, um die Zuverlässigkeit aufrechtzuerhalten.