--- title: "Fehlercodes und Fehlersuche" description: "Ursachen und Lösungen für 401, 404, 429, 529, 5xx, Timeouts und Claude-Code-Fehler beim Aufruf von 1折AI." headingIds: {"Reihenfolge der Fehlersuche":"section-1","Fehlercode-Schnellreferenz":"section-2","Getestete Antworten":"section-3","Fehlersuche nach Symptomen":"section-4","401 / Invalid token":"section-5","004 / Invalid URL":"section-6","403 / error code: 1010":"section-7","429 Zu viele Anfragen":"section-8","529 / overloaded_error":"section-9","Timeouts, Abbruch mitten im Stream":"section-10","Claude Code: Direkt im Anmeldebildschirm":"section-11","Claude Code: Extra inputs are not permitted / context_management meldet 400":"section-12","Guthaben ausreichend, aber Aufruf schlägt fehl":"section-13","Begrenzte Wiederholungen und Feedback-Vorlage":"section-14","Immer noch nicht gelöst":"section-15"} --- Gehen Sie zuerst die folgende Liste der Reihe nach durch – die meisten Probleme lassen sich in den ersten drei Schritten finden. ## Reihenfolge der Fehlersuche 1. **Adresse**: Anthropic-basierte Tools mit `https://1zheai.com` ausfüllen, OpenAI-basierte mit `https://1zheai.com/v1`. Siehe [Base URL und Authentifizierung](/de/docs/base-url/). 2. **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? 3. **Guthaben**: Ist das Guthaben im Konsole ausreichend? 4. **Modell-ID**: Stimmt sie exakt mit der in [unterstützten Modellen](/de/docs/models/) überein? 5. **Netzwerk**: Proxy deaktivieren und direkt verbinden, dann erneut versuchen. 6. **Immer noch nicht gelöst**: Eine minimale curl-Wiedergabe erstellen (siehe unten) und uns die Antwort und die Zeit senden. ```bash title="最小复现" curl -i https://1zheai.com/v1/messages \ -H "x-api-key: sk-你的Key" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -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 support@1zheai.com 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](https://platform.claude.com/docs/en/api/errors). 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`. ```json title="401 API 密钥无效、禁用、过期或额度用完" {"error":{"message":"Invalid token (request id: 202610150244355244812608268d9d6T1pY7T84)","type":"authentication_error"},"type":"error"} ``` ```json title="403 账户余额不足" {"error":{"type":"billing_error","message":"Insufficient user quota, remaining quota: ＄0.000000 (request id: 202610150244418753787808268d9d67YNhvwXd)"},"type":"error"} ``` ```json title="403 API 密钥没开通该模型" {"error":{"message":"This token has no access to model claude-sonnet-4-6 (request id: 202610150244377127013108268d9d6yCiFOxJA)","type":"permission_error"},"type":"error"} ``` ```json title="403 IP 不在白名单" {"error":{"message":"Your IP address is not on this token's allowlist (request id: 202610150244409011371208268d9d63tJvd5GD)","type":"permission_error"},"type":"error"} ``` ```json title="400 上游参数错误" {"error":{"type":"invalid_request_error","message":"messages: Unexpected role \"robot\". Allowed roles are \"user\", \"assistant\" or \"system\" (request id: 202610150245008404167198268d9d6sajV9TX3)"},"type":"error"} ``` ```json title="404 路径不存在" {"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](/de/docs/models/). 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](/de/docs/models/). 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](/de/docs/quickstart-claude-code/) 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): ```bash 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](/de/docs/retries/). Beim Kontaktieren des Supports können Sie die folgende Vorlage kopieren, Schlüssel, Authentifizierungsheader und private Inhalte entfernen und dann senden: ```text 发生时间与时区： 客户端及版本： 请求方法与完整路径： 模型 ID： HTTP 状态码： request id（如有）： 脱敏后的错误正文： 最小请求能否复现： 是否使用代理 / 是否仅某个模型失败： ``` ## Immer noch nicht gelöst Senden Sie eine E-Mail an support@1zheai.com mit Zeitpunkt, Modell-ID, verwendetem Tool und Version sowie der vollständigen Ausgabe von `curl -i` (API-Schlüssel entfernt).