FAQ zur unzensierten API: Registrierung, Abrechnung, Endpunkte, Fehlercodes und Inhaltsgrenzen

Registrierung & Testguthaben

Wie registriere ich mich, brauche ich eine Kreditkarte?

Registriere dich auf der Seite /get-api-key/ mit E-Mail und Passwort, keine Karte nötig. Nach erfolgreicher Registrierung wird der API-Schlüssel sofort angezeigt, keine Wartezeit auf Freischaltung.

Wie hoch ist das Testguthaben für neue Konten und wie lange ist es gültig?

Neue Konten erhalten $0,50 Testguthaben, gültig für 7 Tage. Bei Output-Preisen von $1,00 / 1 Mio. Token entspricht das ca. 500.000 Token, ausreichend für Integrationstests und kleine Validierungen.

Wie viele Schlüssel kann ein Konto haben? Was passiert bei Verlust?

Jedes Konto hat nur einen Schlüssel. Bei Verlust oder Kompromittierung kannst du im Konto einen neuen generieren; der alte wird sofort ungültig. Dienste, die noch den alten Schlüssel nutzen, erhalten 401. Aktualisiere nach dem Wechsel die Umgebungsvariablen.

Was passiert, wenn das Testguthaben abläuft?

Nach Ablauf des Testguthabens erhalten Requests 402 mit dem Fehlercode no_credit. Zum Weiterarbeiten einfach das Prepaid-Guthaben aufladen, der Code muss nicht geändert werden.

Abrechnung & Guthaben

Wie hoch sind die Preise und wie wird abgerechnet?

Abrechnung pro Token: Input $0,25 / 1 Mio. Token, Output $1,00 / 1 Mio. Token. Keine Abonnements, keine Monatsgebühren, du zahlst nur für das, was du nutzt. Siehe Preisseite für Details.

Verfällt das Guthaben?

Nein. Aufgeladenes Prepaid-Guthaben hat keine Ablaufzeit. Nur das $0,50 Testguthaben für neue Konten ist 7 Tage gültig.

Wie erfahre ich, wie viel ein Request gekostet hat?

Das Feld usage in jeder Antwort gibt die Input- und Output-Token an. Multipliziere diese mit den Preisen für die Kosten. Auch im letzten Datenblock von Streaming-Requests steht usage; beachte, dass choices dort ein leeres Array ist.

Wie vermeide ich unerwartet hohe Kosten?

Nutze max_tokens (Standard 2048), um Output zu begrenzen, und kürze bei Multi-Turn-Chats die Historie, damit der Input nicht zu lang wird. Da Prepaid gilt, stoppen Requests bei leerem Guthaben, es entstehen keine Rechnungen über das Guthaben hinaus.

Wie viel kostet ein normaler Request als Beispiel?

Beispiel: 2.000 Input-Token, 500 Output-Token. Kosten: Input ca. $0,0005, Output ca. $0,0005, Summe ca. $0,001. Das entspricht etwa $1 für 1.000 solche Requests. Die genauen Werte findest du im usage-Feld der Antwort.

Was passiert, wenn das Guthaben aufgebraucht ist?

Die API gibt 402 mit dem Fehlercode no_credit zurück. Nach dem Aufladen kannst du weiterarbeiten, ohne den API-Schlüssel neu generieren zu müssen.

Endpunkte & Parameter

Wie lautet die Base URL und der Modellname?

Die Base URL ist https://api.wuxianzhiapi.com/v1, der Modellname ist fest uncensored. Verfügbare Endpunkte: POST /v1/chat/completions und GET /v1/models.

Ist die API mit OpenAI-SDKs kompatibel?

Ja. Die offiziellen Python-openai v1+ und npm-openai v4+ funktionieren, sobald du base_url und den API-Schlüssel anpasst. Siehe Code-Beispiele für Implementierung oder Migrationsanleitung für den Wechsel von anderen APIs.

Wie groß ist das Kontextfenster und wie hoch kann max_tokens sein?

Das Kontextfenster beträgt 100.000 Token (Prompt + Output zusammen). max_tokens ist standardmäßig 2048, maximal 32.000. Der Request-Body darf 8 MB nicht überschreiten.

Unterstützt die API Streaming und Function Calling?

Beides wird unterstützt. Für Streaming setze stream: true; der Server fügt am Ende einen Datenblock mit usage an. Für Function Calling nutze OpenAI-kompatible tools und tool_choice; Tool-Ergebnisse werden als Nachrichten mit role: "tool" zurückgegeben.

Warum steht im letzten Block der Streaming-Antwort kein Text?

Das ist der automatisch angehängte Nutzungsstatistik-Block. choices ist ein leeres Array, usage enthält die Token-Anzahl dieser Anfrage. Prüfe vor dem Auslesen, ob choices leer ist, dann tritt kein Index-Out-of-Bounds-Fehler auf.

Gibt es ein Ratenlimit?

Jeder Schlüssel erlaubt 300 Anfragen pro Minute. Bei Überschreitung wird der Statuscode 429 zurückgegeben; warte einfach und versuche es erneut. Wir empfehlen exponentielles Backoff.

Werden Vektoren, Bilder, Audio oder Fine-Tuning unterstützt?

Keine davon wird unterstützt. Hier steht nur Text-Chat zur Verfügung, es gibt nur das uncensored-Modell, keine Embeddings und keine Bild-, Audio- oder Videogenerierung sowie kein Fine-Tuning.

Fehlercodes

Alle Fehlerantworten sind im JSON-Format mit {"error":{"code":...,"message":...}}. Im Folgenden wird für jeden Statuscode erläutert, wie du ihn behandeln solltest.

Was bedeutet der Fehler 400?

Die Anfrage selbst ist fehlerhaft. Am häufigsten wurde die Summe aus Prompt und max_tokens 100.000 Token überschritten, oder das JSON-Format ist ungültig bzw. die Feldtypen stimmen nicht. Ändere die Anfrage; ein einfacher Retry hilft nicht.

Wie behebe ich 401?

Der Schlüssel ist ungültig oder fehlt. Überprüfe, ob der Header Authorization: Bearer <Schlüssel> gesetzt ist, die Umgebungsvariable aktiviert ist und der Schlüssel nicht neu generiert wurde. Ein alter Schlüssel wird nach der Neugenerierung sofort ungültig.

Was bedeutet 402 no_credit?

Das Guthaben ist aufgebraucht oder das Testguthaben ist abgelaufen. Lade dein Konto auf, um fortzufahren; du musst den Schlüssel nicht wechseln.

Was bedeutet 403 content_blocked?

Die Anfrage hat eine Inhaltsblockierung ausgelöst. Sexuelle Inhalte mit Minderjährigen werden immer blockiert, auch fiktive oder im Rollenspiel. Dies ist nicht konfigurierbar. Ändere den Inhalt der Anfrage; eine identische Wiederholung wird ebenfalls blockiert.

Was bedeutet 404?

Du hast einen nicht existierenden Endpunkt aufgerufen. Häufige Ursachen sind ein falscher URL-Pfad (z. B. fehlendes /v1) oder das Aufrufen nicht unterstützter Endpunkte wie Embeddings oder Bildgenerierung.

Wie gehe ich mit 429 und 503 um?

429 bedeutet, dass du das Ratenlimit von 300 Anfragen pro Minute überschritten hast. 503 hat den Fehlercode upstream_busy und bedeutet, dass das Modell vorübergehend ausgelastet ist; warte einige Sekunden und versuche es erneut. Für beide Fälle eignet sich exponentielles Backoff (siehe Code-Beispiele).

Inhaltsgrenzen

Ist bei „unzensiert“ alles möglich?

Nein. Legale erwachsene Inhalte, fiktionale Kreationen und kontroverse Themen werden nicht abgelehnt, aber sexuelle Inhalte mit Minderjährigen werden immer blockiert (Status 403), egal ob fiktiv oder im Rollenspiel. Die Nutzung muss legal sein.

Für welche Nutzer ist das Produkt gedacht?

Nur für Erwachsene ab 18 Jahren. Wenn du es für Endnutzer-Produkte einsetzt, musst du in deiner Anwendung eine Altersverifikation durchführen und Mechanismen zur Meldung von Inhalten sowie zum Account-Management bereitstellen.

Kann es für Rollenspiel, Romane und Spiele genutzt werden?

Ja, das ist die typischste Anwendung. Prompt-Beispiele und Kostenschätzungen für verschiedene Szenarien findest du im Artikel Anwendungsszenarien.

Wann wird im Rollenspiel 403 zurückgegeben?

Nur wenn eine Inhaltsblockierung ausgelöst wird. Das betrifft typischerweise sexuelle Inhalte mit Minderjährigen, auch in fiktiven Settings. Legale Inhalte zwischen Erwachsenen werden nicht wegen des Rollenspiels abgelehnt. Bei 403 passe die Rolle oder die Handlung an und sende die Anfrage erneut.

Sind die Fakten in der Modellausgabe immer zuverlässig?

Nicht unbedingt. Keine Ablehnung bedeutet nicht, dass der Inhalt korrekt ist. Bei Fakten, Daten, rechtlichen oder medizinischen Aussagen solltest du die Informationen vor der Nutzung selbst verifizieren.

Datenschutz

Werden meine Prompts zum Training des Modells verwendet?

Nein. Von dir gesendete Prompts werden nicht zum Training verwendet.

Wie sollte ich meinen Schlüssel aufbewahren?

Speichere den Schlüssel in den Umgebungsvariablen des Servers. Schreibe ihn nicht in Frontend-Seiten, mobile App-Builds oder öffentliche Code-Repositories. Bei Verdacht auf einen Leak generiere den Schlüssel im Konto sofort neu; der alte Schlüssel wird dann sofort ungültig.

Wie gehe ich mit Benutzerdaten in der Anwendung um?

Das hängt von deinem eigenen Produkt ab. Wir empfehlen, nur die für die Aufgabenerfüllung notwendigen Daten zu senden. Vermeide es, echte Namen, Ausweisnummern oder Kontaktdaten in den Prompt aufzunehmen. Kläre in deiner eigenen Datenschutzerklärung klar, wie die Daten verarbeitet werden.