API-Dokumentation für unzensierte Chat-Vervollständigungen

Schnellstart: Verbindung in Python oder JavaScript

Verbinden Sie sich mit der API, indem Sie Ihre Base-URL aktualisieren und Ihren API-Schlüssel festlegen. Der Endpunkt akzeptiert Standard-Chat-Vervollständigungs-Anfragen und gibt Text zurück. Sie müssen keine benutzerdefinierten Bibliotheken installieren, wenn Sie die offiziellen OpenAI SDKs verwenden, da die Schnittstelle genau ihrer Spezifikation entspricht.

Beginnen Sie mit einer einfachen HTTP-Anfrage, um die Konnektivität zu überprüfen. Verwenden Sie den folgenden curl-Befehl, um eine grundlegende Eingabe an die uncensored Modell. Ersetzen Sie YOUR_API_KEY mit dem Schlüssel, der auf Ihrem Dashboard generiert wurde.

Copycurl https://api.aiplayrolebest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the character persona to a grumpy detective"}]
  }'

Für Python-Entwickler ist der Prozess nahezu identisch. Initialisieren Sie den Client mit Ihrem Schlüssel und der richtigen Basis-URL. Dies stellt sicher, dass alle Anfragen über unsere unzensierten Server geleitet werden, während die Kompatibilität mit bestehender Tooling erhalten bleibt.

Copyfrom openai import OpenAI

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

JavaScript-Nutzer können das gleiche Ergebnis mit dem Node SDK erreichen. Legen Sie den baseURL Eigenschaft auf unseren Endpunkt. Dieser Ansatz ermöglicht es Ihnen, die API mit minimalem Codeaufwand in Webserver oder Backend-Dienste zu integrieren.

Copyimport OpenAI from "openai";

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

Authentifizierung und API-Schlüsselverwaltung

Die Authentifizierung basiert auf einem einzelnen API-Schlüssel, der im Header übergeben wird. Übergeben Sie diesen Schlüssel im Authorization header für jede Anfrage. Wenn der Schlüssel fehlt oder ungültig ist, gibt die API sofort einen 401-Fehler zurück. Dies gewährleistet einen sicheren Zugriff auf Ihr bezahltes Guthaben.

Generieren Sie Ihren Schlüssel im Dashboard. Der Schlüssel wird einmalig bei der Erstellung angezeigt. Speichern Sie ihn sicher in Ihren Umgebungsvariablen. Teilen Sie ihn nicht öffentlich. Jedes Konto unterstützt zu einem Zeitpunkt nur einen aktiven Schlüssel. Die Generierung eines neuen Schlüssels macht den vorherigen sofort ungültig.

Verwenden Sie den Schlüssel in Ihren Anfragen wie folgt: Authorization: Bearer YOUR_API_KEY. Dieses Standard-Header-Format funktioniert mit allen großen SDKs. Halten Sie Ihren Schlüssel bereit für schnelle Iterationen während der Entwicklung.

Parameter des Chat-Vervollständigungs-Endpunkts

Senden Sie Anfragen an den /v1/chat/completions Endpunkt. Fügen Sie Ihr Nachrichten-Array ein und legen Sie das Modell auf uncensored. Sie können Parameter wie temperature und top_p die Kreativität zu steuern. Höhere Werte erzeugen vielfältigere Antworten.

Festlegen max_tokens die Ausgabelänge zu begrenzen. Der Standardwert beträgt 2.048 Tokens, falls nicht angegeben. Das Modell unterstützt ein Kontextfenster von 100.000 Tokens für Prompt plus Vervollständigung. Dies ermöglicht lange Gespräche ohne Truncation. Passen Sie presence_penalty und frequency_penalty um Wiederholungen in Roleplay-Szenarien zu reduzieren.

Nutzen Sie die stop Parameter, um die Generierung bei bestimmten Phrasen zu stoppen. Dies hilft, die Dialogstruktur durchzusetzen. Die seed parameter stellt reproduzierbare Ausgaben für Tests sicher. Diese Tools geben Ihnen präzise Kontrolle über das Verhalten des Modells.

Streaming-Antworten und Nutzungsdaten

Aktivieren Sie Streaming, indem Sie stream: true in Ihrer Anfrage. Die API gibt Text-Chunks zurück, sobald sie generiert werden. Dies verringert die wahrgenommene Latenz für Endbenutzer. Jeder Chunk enthält teilweise Text und Metadaten.

Nutzungsdaten erscheinen im letzten Chunk. Dazu gehören die Anzahl der Input- und Output-Tokens. Prüfen Sie die usage field in the last response object. This allows accurate billing verification without separate API calls. Track token consumption in real-time.

Behandeln Sie das Stream-Ende sorgfältig. Stellen Sie sicher, dass Sie alle Chunks verarbeiten, bevor Sie die Verbindung schließen. Der letzte Chunk enthält die vollständigen Nutzungsstatistiken. Diese Daten sind für die Überwachung von Kosten und Leistung in Produktionsanwendungen unerlässlich.

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)

Fehlerbehandlung und Ratenbegrenzung

Die API begrenzt die Anfragen auf 300 pro Minute pro Schlüssel. Gleichzeitige Anfragen sind auf acht pro Schlüssel begrenzt. Der Anforderungstext darf 8 MB nicht überschreiten. Das Überschreiten dieser Limits führt zu einem 429-Fehler. Implementieren Sie exponentielles Backoff, um vorübergehende Spitzen zu behandeln.

Häufige Fehler umfassen 401 für ungültige Schlüssel und 402 für unzureichendes Guthaben. Eine 402-Antwort zeigt an, dass Ihr vorausbezahltes Guthaben aufgebraucht ist. Laden Sie Ihr Konto auf, um den Dienst fortzusetzen. Fehler verbrauchen keine Tokens, sodass ein Retry nach der Fehlerbehebung kostenlos ist.

Prüfen Sie den Antwortkörper auf detaillierte Fehlermeldungen. Die API gibt ein JSON-Objekt mit einem Fehlertyp und einer Nachricht zurück. Nutzen Sie diese Informationen, um Probleme schnell zu debuggen. Eine ordnungsgemäße Fehlerbehandlung gewährleistet ein reibungsloses Erlebnis für Ihre Benutzer während Perioden hohen Verkehrs.

JSON-Modus und Funktionsaufruf-Leitfaden

Verwenden Sie den JSON-Modus, indem Sie response_format zu {"type": "json_object"}. Dies zwingt das Modell, gültiges JSON auszugeben. Ideal für die Extraktion strukturierter Daten oder API-Antworten. Stellen Sie sicher, dass Ihr Prompt das gewünschte Schema klar beschreibt.

Function Calling ermöglicht es dem Modell, Tools aufzurufen. Definieren Sie Tools im Anfragekörper. Das Modell gibt Tool-Aufrufe zurück, wenn dies angemessen ist. Verarbeiten Sie diese Aufrufe in Ihrer Anwendungslogik. Dies ermöglicht komplexe Multi-Step-Workflows.

Kombinieren Sie den JSON-Modus mit dem Funktionsaufruf für robuste Integrationen. Validieren Sie die JSON-Ausgabe auf der Client-Seite. Verwenden Sie den tool_choice Parameter zur Steuerung, wann Funktionen aufgerufen werden. Diese Flexibilität unterstützt verschiedene Anwendungsarchitekturen. Stellen Sie sicher, dass Ihre Tools für eine optimale Leistung gut definiert sind.

Modelldetails und Kontextfenster-Beschränkungen

The uncensored Das Modell unterstützt einen Kontextfenster von 100.000 Token. Dies umfasst sowohl den Eingabe-Prompt als auch die Ausgabe-Vervollständigung. Die maximale Ausgabe beträgt 16.000 Token pro Anfrage. Dies ermöglicht umfangreiche Rollenspiel-Szenarien, ohne dass der Text mitten im Satz abbricht.

Das Modell ist Open-Weight und auf uneingeschränkte Inhalte abgestimmt. Es lehnt legale erwachsene Themen nicht ab. Es ist kein GPT, Claude oder ein Modell eines anderen Anbieters. Anfragen werden auf unseren dedizierten Servern verarbeitet. Dies gewährleistet konsistente Leistung und niedrige Latenz.

Überwachen Sie die Kontextnutzung, um innerhalb der Limits zu bleiben. Die API verfolgt die Token-Nutzung genau. Fehler und Ablehnungen verbrauchen keine Tokens. Dieses transparente Abrechnungsmodell hilft Ihnen, Kosten vorherzusagen. Planen Sie Ihre Kontextfenster, um den Wert zu maximieren.