Character-AI-API: Wechsle deinen Client in drei Zeilen

Voraussetzungen

Bevor du Code schreibst, benötigst du ein aktives Konto auf characteraiapi.com. Besuche die Seite API-Schlüssel erhalten und registriere dich mit E-Mail und Passwort. Keine Kreditkarte erforderlich. Neue Konten erhalten $0,50 an Testguthaben, die 7 Tage gültig sind. Nach der Registrierung wird dein API-Schlüssel sofort angezeigt. Bewahre diesen Schlüssel sicher auf, da er alle Anfragen am Endpunkt authentifiziert. Du benötigst auch ein unterstütztes Sprach-SDK in deiner Entwicklungsumgebung. Der character ai api-Endpunkt akzeptiert Standard-OpenAI-Parameter, sodass jeder bestehende OpenAI-kompatible Client mit minimalen Änderungen funktioniert.

SDK installieren

Für Python-Projekte installiere das offizielle OpenAI-Paket mit pip. Diese Bibliothek verarbeitet die JSON-Serialisierung und HTTP-Anfragen automatisch. Für Node.js-Anwendungen verwende npm, um das openai-Paket hinzuzufügen. Beide Bibliotheken unterstützen das Streaming und Tool-Calling, wie später in dieser Anleitung beschrieben. Stelle sicher, dass deine SDK-Version neu genug ist, um Server-Sent Events (SSE) für Echtzeit-Token-Streaming zu unterstützen. Wenn du einen benutzerdefinierten HTTP-Client statt eines SDKs verwendest, musst du das JSON-Payload und die SSE-Stream-Parsing manuell gemäß der OpenAI-API-Spezifikation handhaben.

Authentifizierung

Jede Anfrage an die API muss deinen API-Schlüssel im Authorization-Header enthalten. Verwende das Format Bearer YOUR_API_KEY. Die Basis-URL für alle Anfragen ist https://api.characteraiapi.com/v1. Wenn du ein SDK verwendest, stelle die base_url-Konfiguration auf diesen Wert ein und gib deinen Schlüssel über den Parameter api_key an. Wenn du deinen Schlüssel verlierst oder einen Leak vermutest, kannst du ihn im Dashboard neu generieren; der alte Schlüssel wird sofort widerrufen. Pro Konto ist nur ein aktiver Schlüssel erlaubt. Stelle sicher, dass du die korrekte Basis-URL verwendest, da Anfragen an den Standard-OpenAI-Endpunkt mit einem 404- oder 401-Fehler fehlschlagen.

Einfache Chat-Vervollständigung

Die Kernfunktionalität wird über den Endpunkt /v1/chat/completions bereitgestellt. Sende eine POST-Anfrage mit einem Modellnamen von uncensored und deinem Nachrichtenverlauf. Das Modell antwortet mit Textausgabe, ohne Standard-Inhaltsfilter für legale erwachsene Inhalte anzuwenden. Unten findest du ein curl-Beispiel, das eine einfache Textvervollständigungsanfrage demonstriert.

Copycurl https://api.characteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Diese Anfrage gibt ein Vervollständigungsobjekt zurück, das den generierten Text enthält. Du kannst Parameter wie temperature anpassen, um die Zufälligkeit zu steuern, oder max_tokens, um die Ausgabelänge zu begrenzen. Das Modell unterstützt ein Kontextfenster von 100.000 Token, was es ermöglicht, umfangreiche Gesprächsverläufe oder lange Dokumente in einer einzigen Anfrage zu verarbeiten.

Streaming-Antworten

Für eine bessere Benutzererfahrung aktiviere das Streaming, indem du stream: true in deiner Anfrage einstellst. Die API gibt Server-Sent Events (SSE) zurück, die partielle Token-Chunks enthalten, sobald sie generiert werden. Dies reduziert die wahrgenommene Latenz für Chatbot-Anwendungen. Verwende den Parameter stream_options, wenn du die finalen Nutzungsinformationen im letzten Event erhalten möchtest. Streaming ist besonders nützlich für Echtzeit-Charakter-Rollenspiele, bei denen die schrittweise Anzeige von Text die Immersion erhöht. Stelle sicher, dass dein Client-Code das SSE-Format korrekt verarbeitet, um jeden Chunk sequenziell zu parsen.

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)

Ratenlimits und Fehler

Die API erzwingt ein Limit von 300 Anfragen pro Minute pro Schlüssel. Wenn du dieses überschreitest, erhältst du einen 429 Too Many Requests-Fehler. Anfragekörper sind auf 8 MB begrenzt. Häufige Fehler sind 401 für einen ungültigen oder fehlenden Schlüssel und 402, wenn dein Prepaid-Guthaben aufgebraucht ist. Du kannst ab 10 $ per Krypto (USDT oder USDC) aufladen, wobei für größere Einzahlungen Bonusguthaben verfügbar ist. Im Gegensatz zu einigen Anbietern gibt es keine versteckten Gebühren oder Abonnement-Sperren; du zahlst nur für die Tokens, die du verbrauchst. Die Preise sind transparent: 0,25 $ pro 1 Mio. Input-Token und 1,00 $ pro 1 Mio. Output-Token. Stelle sicher, dass deine Fehlerbehandlungslogik bei 429-Fehlern mit exponentiellem Backoff wiederholt.

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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