Fehler

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.