DE ▾
API-Schlüssel erhalten

Character AI API-Schlüssel: So erhältst und nutzt du ihn

Wenn du nach einem Character AI API-Schlüssel gesucht hast, ist das Erste, was du wissen musst, dass diese Seite nicht Character.ai ist und keine Schlüssel davon ausstellt. Sie gibt dir einen Schlüssel für eine unabhängige, OpenAI-kompatible Text-API, die sich als sofort einsetzbares Backend für Charakter-Chat-Apps eignet.

Ein leuchtender Schlüssel über Chat-Panels, die mit einem Server-Würfel verbunden sind, veranschaulicht den API-Schlüsselzugriff

Wichtige Punkte

  1. Du erhältst einen Schlüssel nach der Anmeldung mit Google oder E-Mail und Passwort, indem du die API-Schlüssel-Seite öffnest.
  2. Neue Nutzer können mit einem Klick $0,50 Testguthaben beanspruchen, keine Kreditkarte erforderlich, gültig für 7 Tage.
  3. Verwende die Basis-URL https://api.characteraiapi.com/v1 und die Modell-ID uncensored mit jedem OpenAI SDK.
  4. Bewahre den Schlüssel auf einem Server oder in einer Umgebungsvariable auf, niemals im öffentlichen Frontend-Code.

Was du tatsächlich erhältst

Character.ai ist ein Consumer-Chat-Produkt. Personen, die nach einem Character AI API-Schlüssel suchen, wollen meist eines von zwei Dingen: eine Möglichkeit, einen Charakter-Chatbot aus ihrem eigenen Code heraus aufzurufen, oder ein Backend für eine Persona-App, das nicht durch die Regeln eines gehosteten Produkts begrenzt ist. Diese Seite deckt das zweite Bedürfnis ab. Du meldest dich an, erhältst einen Schlüssel und sendest Anfragen an einen OpenAI-kompatiblen Endpunkt. Hier wird nichts mit Character.ai verbunden oder dessen Charaktere wiederverwendet.

Der Dienst ist eine gehostete Text-API vor einem Open-Weight-Modell, betrieben von einem unabhängigen Anbieter und darauf abgestimmt, ohne Inhaltsfilter für die rechtmäßige Nutzung durch Erwachsene zu antworten. Es ist nicht die offizielle API eines Modell-Anbieters und kein Router über Anbieter hinweg. Die Modell-ID ist uncensored, und die Basis-URL ist https://api.characteraiapi.com/v1. Es gibt zwei Methoden: POST /v1/chat/completions und GET /v1/models.

Da die Schnittstelle der von OpenAI entspricht, liegt die Arbeit am Aufbau einer Persona auf deiner Seite. Du schreibst die Persona als Systemnachricht, behältst den Konversationsverlauf bei und sendest ihn mit jeder Anfrage. Das gibt dir Kontrolle über Stimme, Gedächtnis und Tempo, die ein geschlossenes Produkt selten bietet. Die harte Grenze ist für jeden Nutzer gleich: Keine sexuellen Inhalte mit Minderjährigen, jederzeit.

Hole deinen Schlüssel in fünf Schritten

Der gesamte Vorgang dauert nur wenige Minuten. Du brauchst keine Kreditkarte zum Starten.

  1. Anmelden. Nutze Google oder registriere dich mit einer E-Mail und einem Passwort.
  2. Öffne die Schlüsselseite. Gehe zur API-Schlüssel-Seite, wo der Schlüssel deines Kontos angezeigt wird.
  3. Testguthaben beanspruchen. Ein Klick auf dieser Seite fügt $0,50 Testguthaben hinzu. Es ist auf einen pro Person begrenzt und 7 Tage gültig.
  4. Schlüssel kopieren. Speichere ihn sofort in einem Passwortmanager oder einer Secrets-Datei.
  5. Testanfrage senden. Nutze den unten stehenden curl-Befehl, bevor du App-Code berührst.

Behandle den Schlüssel wie ein Passwort. Jeder, der ihn hat, kann dein Guthaben ausgeben. Wenn du glaubst, dass er geleakt wurde, nutze ihn sofort nicht mehr, entferne ihn aus jeder App und prüfe dein Guthaben auf unerwartete Ausgaben.

Teste den Schlüssel mit curl

Lege den Schlüssel als Umgebungsvariable fest, damit er nicht als Klartext in deiner Shell-Historie oder in einem Skript landet. Liste dann die Modelle auf. Dies bestätigt, dass der Schlüssel funktioniert und du den richtigen Host erreichst.

export API_KEY="paste-your-key-here"

curl https://api.characteraiapi.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Du solltest eine JSON-Liste erhalten, die uncensored enthält. Sende nun eine erste Chat-Anfrage mit einer kleinen Persona. Die Systemnachricht setzt die Figur, die Benutzernachricht startet die Szene.

curl https://api.characteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship engineer in a space opera. Stay in character."},
      {"role": "user", "content": "The reactor is humming wrong again. What do you do?"}
    ],
    "temperature": 0.9
  }'

Die Antwort folgt der Standardstruktur für Chat-Vervollständigungen. Der Antworttext steht in choices[0].message.content. Die Antwort-Header enthalten auch X-Request-Id, X-Balance-USD und die Ratenlimit-Header, was praktisch ist, wenn du dein verbleibendes Guthaben in deiner eigenen UI anzeigen möchtest.

Verwende den Schlüssel aus Python oder Node

Jedes OpenAI SDK funktioniert, sobald du zwei Werte änderst: die Basis-URL und den Schlüssel. Hier ist die Python-Version mit dem offiziellen openai-Paket.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.characteraiapi.com/v1",
    api_key=os.environ["API_KEY"],
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are Mara, a ship engineer. Stay in character."},
        {"role": "user", "content": "Status report?"},
    ],
)
print(reply.choices[0].message.content)

Und derselbe Aufruf in Node:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.characteraiapi.com/v1",
  apiKey: process.env.API_KEY,
});

const reply = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "system", content: "You are Mara, a ship engineer. Stay in character." },
    { role: "user", content: "Status report?" },
  ],
});
console.log(reply.choices[0].message.content);

Viele Chat-Frontends haben ein Feld für einen benutzerdefinierten OpenAI-kompatiblen Endpunkt. In diesen Tools fügst du die Basis-URL ein, fügst den Schlüssel ein und gibst uncensored als Modellnamen ein. Nichts anderes muss geändert werden. Die Dokumentationsseite listet die unterstützten Parameter auf, einschließlich Streaming, Function Calling und JSON-Modus.

Häufige Schlüsselprobleme und schnelle Lösungen

Die meisten Fehler beim ersten Mal resultieren aus wenigen kleinen Fehlern. Prüfe sie in dieser Reihenfolge, bevor du etwas Größeres vermutest.

  • Zusätzliche Leerzeichen oder Anführungszeichen im Schlüssel. Ein nachgestellter Zeilenumbruch, der aus einer Datei kopiert wurde, reicht aus, um die Authentifizierung fehlschlagen zu lassen. Drucke die Länge der Variable aus und vergleiche sie mit dem, was du kopiert hast.
  • Falsche Basis-URL. Die Basis-URL endet mit /v1, und das SDK hängt /chat/completions selbst an. Wenn du auch /chat/completions zur Basis-URL hinzufügst, verdoppelt sich der Pfad und die Anfrage schlägt fehl.
  • Falscher Modellname. Die Modell-ID ist uncensored. Namen, die von anderen Diensten übernommen wurden, passen nicht. Rufe GET /v1/models auf, um zu sehen, was der Server meldet.
  • Fehlender Header. Rohe HTTP-Aufrufe benötigen Authorization: Bearer gefolgt von einem Leerzeichen und dem Schlüssel, plus Content-Type: application/json bei POST-Anfragen.
  • Leeres Guthaben. Der Antwort-Header X-Balance-USD zeigt den Rest an. Wenn das Testguthaben aufgebraucht ist oder die 7 Tage abgelaufen sind, lade auf, sonst schlagen Anfragen fehl.
  • Ratenlimits. Ein Testschlüssel erlaubt 2 parallele Anfragen und 60 pro Minute. Zwei offene Streams belegen bereits beide Slots.

Ein falscher Schlüssel erzeugt typischerweise einen Authentifizierungsfehler statt einer Modellantwort. Ein Limit erzeugt HTTP 429 mit dem Code rate_limited oder concurrency. Das Lesen des Fehlerkörpers, nicht nur des Statuscodes, spart Zeit, weil der Code dir sagt, welches Limit du erreicht hast. Jede Antwort enthält eine X-Request-Id; speichere sie in deinen Logs, damit du einen fehlgeschlagenen Aufruf später einer bestimmten Anfrage zuordnen kannst.

Testlimits und was das Testguthaben bringt

Ein Test-Schlüssel hat niedrigere Limits als ein vollwertiger: 2 parallele Anfragen und 60 Anfragen pro Minute. Ein vollwertiger Schlüssel erlaubt 8 parallele Anfragen und 300 Anfragen pro Minute. Für das Testen einer einzelnen Persona ist das mehr als genug. Wenn du mehrere Chats gleichzeitig aus einem Testskript startest, siehst du HTTP 429 mit dem Fehlercode concurrency oder rate_limited. Eine gestreamte Anfrage belegt ihren Concurrency-Slot bis das Streaming endet, daher füllen zwei offene Streams auf einem Test-Schlüssel diesen.

Wie weit reicht $0,50? Die Preise sind $0,15 pro 1M Input-Token und $0,50 pro 1M Output-Token. Nimm einen typischen Chat-Zug mit 1.500 Token an Historie und Persona, die eingehen, und 300 Token, die ausgehen:

  • Input: 1.500 Token x $0,15 / 1.000.000 = $0,000225
  • Output: 300 Token x $0,50 / 1.000.000 = $0,00015
  • Ein Zug: $0,000375
  • $0,50 / $0,000375 sind etwa 1.333 Züge

Das reicht aus, um mehrere Charaktere gründlich zu testen. Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet, also frisst eine Anfrage, die einen Fehler auslöst, nicht dein Guthaben. Das Testguthaben läuft nach 7 Tagen ab; Guthaben, das du später kaufst, verfällt nie.

Einstellungen, damit eine Persönlichkeit richtig wirkt

Ein Schlüssel gibt dir die Verbindung; die Qualität eines Charakters kommt vom Prompt und den Sampling-Einstellungen. Ein paar Gewohnheiten helfen mehr als clevere Tricks.

Schreibe die Systemnachricht als kurzes Charakter-Sheet in klaren Sätzen: Wer die Figur ist, wie sie spricht, was sie will und wie lang ihre Antworten sein sollen. Gib ein oder zwei Beispielzeilen Dialog an, wenn die Stimme wichtig ist. Modelle folgen konkreten Beispielen besser als Adjektiven, daher funktioniert eine Zeile wie „Mara antwortet in kurzen, trockenen Sätzen und macht Witze, wenn sie nervös ist“ besser als „Mara ist witzig und charmant“.

Verwende temperature, um die Lebhaftigkeit festzulegen. Werte nahe 0,9 ergeben eine größere Variation der Formulierungen, während Werte nahe 0,5 die Figur stabiler halten. Füge eine stop-Sequenz hinzu, wenn deine Anwendung ein Sprecher-Label wie „Benutzer:“ verwendet und du verhindern möchtest, dass das Modell die andere Seite des Gesprächs schreibt. Die Frequency- und Presence-Penalties können wiederholte Phrasen in langen Chats reduzieren, aber erhöhe sie vorsichtig, da hohe Werte den Dialog seltsam machen können.

Denke daran, dass das Modell nur das kennt, was in der Anfrage steht. Wenn die Figur sich an den Namen des Spielers vor 200 Nachrichten erinnern soll, behalte diese Nachricht entweder im Kontextfenster oder speichere wichtige Fakten in der Systemnachricht. Deshalb schlägt eine eigene, gepflegte Speicherliste oft eine riesige Historie.

Aufladen, wenn das Testguthaben aufgebraucht ist

Es gibt kein Abonnement. Du zahlst im Voraus und gibst pro Token aus. Aufladungen nehmen jeden beliebigen Gesamtbetrag von 20 $ bis 500 $ an, und höhere Beträge haben einen Bonus: +5 % ab 50 $, +10 % ab 100 $ und +15 % ab 200 $. Aus 50 $ werden also 52,50 $ Guthaben, aus 100 $ werden 110 $ und aus 200 $ werden 230 $. Du kannst mit Mit Krypto (USDT auf TRC20, USDC auf Base) bezahlen.

Die Preisseite enthält die vollständige Tabelle. Zur Planung: Eine Runde mit 1.500 Input-Token und 300 Output-Token kostet 0,000375 $, also reichen 20 $ für etwa 53.000 solcher Runden. Langes Roleplay kostet pro Runde mehr, weil der Verlauf wächst, also begrenze, wie viel davon du erneut sendest. Das Kontextfenster umfasst 100.000 Token, Prompt plus Antwort, aber du wirst es selten voll ausfüllen wollen.

Den Schlüssel in einer echten App sicher aufbewahren

Der häufigste Fehler bei einem Chat-Projekt ist der direkte Aufruf der API aus Browser-Code. Alles, was an den Browser ausgeliefert wird, kann von jedem Besucher gelesen werden, einschließlich des Schlüssels. Platziere einen kleinen Server zwischen deinem Frontend und der API. Der Browser spricht mit deiner Route, deine Route fügt den Authorization: Bearer-Header hinzu und leitet die Anfrage weiter.

  • Speichere den Schlüssel in einer Umgebungsvariable oder einem Secrets-Manager, nicht im Repository.
  • Füge einen .env-Eintrag zu .gitignore hinzu, bevor du deinen ersten Commit erstellst.
  • Verwende einen Schlüssel pro Umgebung, damit ein Datenleck in der Entwicklung die Produktion nicht beeinträchtigt.
  • Beobachte den X-Balance-USD-Header, um aus der Kontrolle geratene Schleifen früh zu erkennen.
  • Wiederhole bei HTTP 429 nach einer kurzen Wartezeit. Eine temporäre Überlastungsantwort enthält Retry-After: 5.

Prompts, die an die API gesendet werden, werden nicht zum Training verwendet. Vermeide dennoch das Senden von Daten, die du nicht in einem Log auf deiner eigenen Seite speichern möchtest. Wenn du dir genauer ansehen möchtest, was eine solche API tut und nicht tut, behandelt der Mythen und Fakten-Artikel häufige Missverständnisse.

Fragen und Antworten

Erhalte ich damit einen Character.ai-API-Schlüssel?

Nein. Dies ist ein separater, unabhängiger Dienst. Du erhältst einen Schlüssel für einen OpenAI-kompatiblen Endpunkt mit der Modell-ID uncensored, den du als Backend für deine eigenen Charakter-Apps nutzen kannst.

Brauche ich eine Karte, um einen Schlüssel zu erhalten?

Nein. Du meldest dich mit Google oder E-Mail und Passwort an und beanspruchst 0,50 $ Testguthaben mit einem Klick auf der API-Schlüssel-Seite. Das Testguthaben ist 7 Tage gültig.

Kann ich den Schlüssel in SillyTavern oder anderen Chat-Frontends verwenden?

Tools, die einen benutzerdefinierten OpenAI-kompatiblen Endpunkt akzeptieren, können ihn nutzen. Gib die Basis-URL, deinen Schlüssel und den Modellnamen uncensored ein.

Was passiert, wenn ich ein Ratenlimit erreiche?

Die API gibt HTTP 429 mit dem Code rate_limited oder concurrency zurück. Warte einen Moment und wiederhole die Anfrage. Ein Test-Schlüssel erlaubt 2 gleichzeitige Anfragen und 60 pro Minute.

Verfällt das Guthaben?

Gekauftes Guthaben verfällt nie. Nur das Testguthaben von 0,50 $ hat ein 7-Tage-Fenster.

Dein Schlüssel ist nur ein Formular entfernt

Erstelle ein Konto, kopiere den Schlüssel, ändere die Basis-URL. Das ist die gesamte Einrichtung.

API-Schlüssel erhalten