Fehlercodes und Fehlersuche

Ursachen und Lösungen für 401, 404, 429, 529, 5xx, Timeouts und Claude-Code-Fehler beim Aufruf von 1折AI.

Gehen Sie zuerst die folgende Liste der Reihe nach durch – die meisten Probleme lassen sich in den ersten drei Schritten finden.

Reihenfolge der Fehlersuche

Adresse: Anthropic-basierte Tools mit https://1zheai.com ausfüllen, OpenAI-basierte mit https://1zheai.com/v1. Siehe Base URL und Authentifizierung.
API-Schlüssel (API key): Ist er vollständig (ohne zusätzliche Leerzeichen oder Zeilenumbrüche), wurde er gelöscht, und ist er im richtigen Feld eingetragen?
Guthaben: Ist das Guthaben im Konsole ausreichend?
Modell-ID: Stimmt sie exakt mit der in unterstützten Modellen überein?
Netzwerk: Proxy deaktivieren und direkt verbinden, dann erneut versuchen.
Immer noch nicht gelöst: Eine minimale curl-Wiedergabe erstellen (siehe unten) und uns die Antwort und die Zeit senden.

1
curl -i https://1zheai.com/v1/messages \
2
  -H "x-api-key: sk-你的Key" \
3
  -H "anthropic-version: 2023-06-01" \
4
  -H "content-type: application/json" \
5
  -d '{"model":"claude-sonnet-5-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

-i gibt den Statuscode und die Antwortheader mit aus, was bei der Fehlersuche sehr nützlich ist.

Fehlercode-Schnellreferenz

Statuscode	Häufige Ursache	Was zu tun ist
400	Problem mit dem Anfragekörper: falscher Parametername, falscher Feldtyp, `max_tokens` überschreitet das Modelllimit, enthaltenes Beta-Feld wird vom Upstream nicht anerkannt	Das in `message` angegebene Feld prüfen; für Claude Code siehe unten „Extra inputs are not permitted“
401	API-Schlüssel ungültig, gelöscht, deaktiviert, abgelaufen, eigenes Kontingent aufgebraucht, oder fehlt bzw. ist im falschen Header platziert	Die Antwort enthält immer `Invalid token` – Punkt für Punkt prüfen; Anthropic-nativ verwendet `x-api-key` oder `Authorization: Bearer`
403	Unzureichendes Kontoguthaben (`billing_error` / `insufficient_quota`); dieser API-Schlüssel hat das Modell nicht freigeschaltet; die Anfrage-IP steht nicht auf der Whitelist dieses API-Schlüssels (alles `permission_error`)	Aufladen oder auf der Seite „API-Schlüssel“ die Modellbeschränkungen und die IP-Whitelist dieses API-Schlüssels bearbeiten
004	Pfad falsch oder Modell existiert nicht / derzeit nicht verfügbar	`Invalid URL` Adresse prüfen; `not_found_error` / `model_not_found` Modell-ID und verfügbare Liste prüfen
413	Anfragekörper zu groß	Inhalt pro Anfrage reduzieren, große Dateien aufteilen
429	Temporäres Rate-Limiting durch den Upstream. Wir setzen derzeit keine Ratenlimits auf API-Schlüssel	Später erneut versuchen, bei Stapelverarbeitung exponentielles Backoff hinzufügen
503	Modell vorhanden, aber derzeit kein gesunder Upstream-Dienst verfügbar, oder temporärer Dienstfehler	Später erneut versuchen; bei anhaltendem Fehler die Anfrage-ID angeben und den Support kontaktieren
500 / 502	Temporärer Gateway- oder Upstream-Fehler	Später erneut versuchen; bei anhaltendem Auftreten E-Mail an [email protected] senden
504	Anfrage-Timeout	Für lange Ausgaben Streaming verwenden; Client-Timeout erhöhen
529	Upstream-Anthropic überlastet (`overloaded_error`)	Einige Sekunden warten und erneut versuchen oder vorübergehend ein anderes Modell verwenden

Die vollständige Bedeutung der offiziellen Anthropic-Fehlertypen (invalid_request_error, authentication_error, rate_limit_error, overloaded_error usw.) finden Sie in der offiziellen Errors-Dokumentation.

Vom Upstream zurückgegebene Fehler werden mit Statuscode und message unverändert weitergegeben; message wird am Ende um die request id dieser Anfrage ergänzt. Bei /v1/messages ist die äußere Struktur die offizielle {"type":"error","error":{...}}-Struktur, error.type wird je nach Statuscode mit dem offiziellen Typ gefüllt; bei /v1/chat/completions handelt es sich um die OpenAI-Struktur {"error":{...}}.

Getestete Antworten

Nachfolgend die echten Antworten vom 15.10.2026 bei /v1/messages. Bei /v1/chat/completions ist der Inhalt identisch, die äußere Schicht hat kein "type":"error", und error enthält zusätzlich ein Feld code.

{"error":{"message":"Invalid token (request id: 202610150244355244812608268d9d6T1pY7T84)","type":"authentication_error"},"type":"error"}

{"error":{"type":"billing_error","message":"Insufficient user quota, remaining quota: ＄0.000000 (request id: 202610150244418753787808268d9d67YNhvwXd)"},"type":"error"}

{"error":{"message":"This token has no access to model claude-sonnet-4-6 (request id: 202610150244377127013108268d9d6yCiFOxJA)","type":"permission_error"},"type":"error"}

{"error":{"message":"Your IP address is not on this token's allowlist (request id: 202610150244409011371208268d9d63tJvd5GD)","type":"permission_error"},"type":"error"}

{"error":{"type":"invalid_request_error","message":"messages: Unexpected role \"robot\". Allowed roles are \"user\", \"assistant\" or \"system\" (request id: 202610150245008404167198268d9d6sajV9TX3)"},"type":"error"}

{"error":{"message":"Invalid URL (POST /v1/nonexistent)","type":"invalid_request_error","param":"","code":""}}

Eine Erläuterung des 404, wenn das Modell nicht existiert oder nicht verfügbar ist, finden Sie in unterstützten Modellen. Die request id in der Antwort entspricht genau dieser Anfrage – bitte bei Problemmeldungen angeben.

Fehlersuche nach Symptomen

401 / Invalid token

Beim Kopieren des API-Schlüssels sind Leerzeichen oder Zeilenumbrüche hinzugekommen – erneut kopieren.
Der API-Schlüssel wurde in der Konsole gelöscht oder deaktiviert, ist abgelaufen oder das eigene Kontingent ist aufgebraucht. In all diesen Fällen lautet die Antwort exakt derselbe Satz Invalid token.
In Claude Code sind gleichzeitig ANTHROPIC_API_KEY und ANTHROPIC_AUTH_TOKEN gesetzt, wobei einer der alte Wert ist: Nur eines behalten, empfohlen ist ANTHROPIC_AUTH_TOKEN.
settings.json in env überschreibt die gleichnamige Variable, die im Terminal exportiert wurde. Wenn die Änderung der Terminal-Variable nicht wirkt, prüfen Sie ~/.claude/settings.json.

004 / Invalid URL

Zuerst den Fehlertyp ansehen: not_found_error oder model_not_found erfordern die Prüfung der Modell-ID und verfügbaren Liste. Bei Invalid URL stattdessen /v1 prüfen: OpenAI SDK, Cursor, Cline (OpenAI Compatible) müssen in https://1zheai.com/v1 eingetragen werden; Claude Code und Anthropic SDK nur https://1zheai.com, das Eintragen von /v1 führt zu /v1/v1/messages.

403 / error code: 1010

Wenn die Antwort nur die Zeile error code: 1010 enthält und kein JSON, wurde die Anfrage vor Erreichen des Gateways blockiert. Bisher ist bekannt, dass dies beim direkten Senden mit der Python-Standardbibliothek urllib auftritt (deren Standard-User-Agent ist Python-urllib/3.x). Fügen Sie in den Anfrageheadern einen eigenen User-Agent hinzu oder verwenden Sie stattdessen das offizielle SDK, requests, httpx.

429 Zu viele Anfragen

Derzeit werden keine Ratenlimits auf API-Schlüssel gesetzt. Bei Erhalt von 429 liegt in der Regel eine hohe Upstream-Last vor – später erneut versuchen. Für Stapelverarbeitung wird exponentielles Backoff empfohlen: Nach einem Fehler eine Weile warten, die Wartezeit bei jedem Versuch verdoppeln und die Parallelität selbst über eine Warteschlange steuern.

529 / overloaded_error

Der Upstream-Anthropic ist vorübergehend überlastet, unabhängig von Ihrem API-Schlüssel oder Guthaben. Einige Sekunden warten und erneut versuchen; falls es eilt, vorübergehend auf ein anderes Modell derselben Serie wechseln.

Timeouts, Abbruch mitten im Stream

Lange Antworten nach Möglichkeit mit Streaming ("stream": true) – so werden sie nicht so leicht von Netzwerkgeräten dazwischen getrennt.
Claude Code kann mit API_TIMEOUT_MS den Timeout erhöhen, Standard ist 600000 (10 Minuten).
Wenn ein Proxy aktiv ist, zuerst den Proxy deaktivieren und erneut versuchen – viele Stream-Abbrüche stammen vom Proxy-Knoten.

Claude Code: Direkt im Anmeldebildschirm

Das bedeutet, dass Claude Code Ihren API-Schlüssel nicht gelesen hat. Führen Sie in Claude Code /status aus und prüfen Sie die Zeilen für Base URL und Anmeldedatenquelle; wenn leer, zurück zu Claude-Code-Anbindung und Umgebungsvariablen oder settings.json prüfen.

Claude Code: Extra inputs are not permitted / context_management meldet 400

Claude Code sendet einige experimentelle Beta-Felder mit der Anfrage; strenge Upstreams erkennen diese nicht und melden dann 400. Setzen Sie die folgende Umgebungsvariable, um sie zu deaktivieren (aus der offiziellen Claude-Code-LLM-Gateway-Dokumentation):

1
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

Guthaben ausreichend, aber Aufruf schlägt fehl

Wenn nur ein bestimmtes Modell fehlschlägt, ist es möglicherweise derzeit nicht verfügbar, die ID ist falsch geschrieben, oder dieser API-Schlüssel hat eine Modellbeschränkung (403 This token has no access to model …).
Wenn alle fehlschlagen und es 401 ist, prüfen Sie, ob für diesen API-Schlüssel ein Kontingentlimit gesetzt und bereits aufgebraucht ist oder ob er abgelaufen ist. Auf der Seite „API-Schlüssel“ in den Spalten „Kontingent ($)“ und „Ablauf“ einsehbar.
Für andere Fälle die Fehlercodetabelle oben konsultieren.

Begrenzte Wiederholungen und Feedback-Vorlage

Verdecken Sie keine Konfigurationsfehler mit Endlosschleifen. SDK-Timeouts, automatische Wiederholungsanzahl und Backoff-Verhalten siehe Timeouts und Wiederholungen.

Beim Kontaktieren des Supports können Sie die folgende Vorlage kopieren, Schlüssel, Authentifizierungsheader und private Inhalte entfernen und dann senden:

1
发生时间与时区：
2
客户端及版本：
3
请求方法与完整路径：
4
模型 ID：
5
HTTP 状态码：
6
request id（如有）：
7
脱敏后的错误正文：
8
最小请求能否复现：
9
是否使用代理 / 是否仅某个模型失败：

Immer noch nicht gelöst

Senden Sie eine E-Mail an [email protected] mit Zeitpunkt, Modell-ID, verwendetem Tool und Version sowie der vollständigen Ausgabe von curl -i (API-Schlüssel entfernt).