Fehler
HTTP-Fehlercodes, Antwortformate und Wiederholungsregeln.
| HTTP | Bedeutung | Empfohlene Maßnahme |
|---|---|---|
| 400 | Ungültige Anfrage | Korrigieren Sie JSON und erforderliche Felder |
| 401 | Ungültiger, eingefrorener oder widerrufener Schlüssel | Den Schlüssel drehen oder entsperren |
| 402 | Unzureichender Kontostand oder Schlüsselnutzungslimit erreicht | Fügen Sie Geld hinzu oder setzen Sie das Schlüssellimit zurück/erhöhen Sie es |
| 403 | Das Modell ist für den von einer API-Zulassungsliste abgelehnten Schlüssel oder die Quell-IP nicht verfügbar | Aktualisieren Sie die Schlüsselberechtigungen oder verwenden Sie eine zulässige Quell-IP |
| 404 | Unbekannter Endpunkt, unbekanntes Modell oder unbekannte asynchrone Anfrage | Überprüfen Sie die Kennung und den Pfad |
| 413 | Anfrage zu groß | Reduzieren Sie die Kontextgröße |
| 429 | RPM oder Parallelität überschritten | Ehre Retry-After |
| 500 | Gateway-Fehler | Versuchen Sie es noch einmal und überprüfen Sie die Protokolle |
| 502/503/504 | Upstream nicht verfügbar oder Zeitüberschreitung | Versuchen Sie es erneut mit exponentiellem Backoff |
Zahlung erforderlich
Unzureichendes Firmen-/Kontoguthaben gibt HTTP zurück 402 Payment Required im OpenAI-kompatiblen Umschlag:
{
"error": {
"message": "Insufficient account balance.",
"type": "payment_required",
"code": "insufficient_balance"
}
}Derselbe stabile Grund/Code wird im Anforderungsverlauf aufgezeichnet. A 402 Die Anfrage wird vor der Ausführung durch den Anbieter abgelehnt und sollte nicht automatisch erneut versucht werden, bis die Finanzierung oder die geltenden Ausgabenbeschränkungen korrigiert wurden.
Ablehnung der IP-Zulassungsliste
Wenn ein authentifizierter API-Schlüssel gültig ist, die Quelladresse jedoch außerhalb der effektiven API-Zulassungsliste für Privatpersonen oder Unternehmen liegt, lehnt Model Gate die Anfrage vor der Upstream-Ausführung ab. OpenAI-kompatible Antworten verwenden HTTP 403 mit Code ip_not_allowed. Anthropic-kompatible Antworten verwenden den Anthropic-Fehlerumschlag mit HTTP 403 Und authentication_error. Versuchen Sie es nicht erneut mit derselben unzulässigen Quelle. Ändern Sie die konfigurierte Zulassungsliste oder senden Sie die Anfrage von einer zulässigen Adresse.
Wiederholen 429 nach Retry-After. Wiederholen 500, 502, 503, Und 504 bis zu dreimal mit 1/2/4-Sekunden-Backoff. Führen Sie keine automatischen Wiederholungsversuche bei Validierungs-, Authentifizierungs-, Kontostand- oder nicht gefundenen Fehlern durch.
Verwenden Sie die öffentliche Anforderungs-ID von X-Request-ID um die Antwort mit dem zu korrelieren Anforderungsprotokoll.
Fehler nach Stream-Headern
SSE kann fehlschlagen, nachdem HTTP200 bereits gesendet wurde. Die Antwort enthält dann ein protokollkompatibles Fehlerereignis; Der Gateway-Anforderungsverlauf zeichnet den Terminalausfall unabhängig vom Leitungsstatus auf. Unbekannte Upstream-Nachrichten werden standardmäßig ausgeblendet, genehmigte Nachrichten können durch Administratorrichtlinien offengelegt werden und die vollständige Offenlegung von Upstream-Fehlern ist explizit. Interne Upstream-Metadaten und temporäre Rohdaten bleiben nur dem Administrator vorbehalten. Fehlende Nutzung nach einem unterbrochenen Stream ist unbekannt/überprüfungspflichtig, keine automatische Schätzung aus Wire-Bytes. Behalten Sie die Anforderungs-ID bei und versuchen Sie es nur absichtlich erneut, nachdem Sie die Teilausgabe überprüft haben.