Błędy
Kody błędów HTTP, formaty odpowiedzi i reguły ponawiania prób.
Błędy
| HTTP | Oznaczający | Zalecane działanie |
|---|---|---|
| 400 | Nieprawidłowe żądanie | Popraw JSON i wymagane pola |
| 401 | Nieprawidłowy, zablokowany lub unieważniony klucz | Obróć lub odblokuj klucz |
| 402 | Niewystarczające saldo konta lub osiągnięto limit wykorzystania klucza | Dodaj środki lub zresetuj/zwiększ limit klucza |
| 403 | Model niedostępny dla klucza lub źródłowego adresu IP odrzuconego przez listę dozwolonych interfejsów API | Zaktualizuj kluczowe uprawnienia lub użyj dozwolonego źródłowego adresu IP |
| 404 | Nieznane żądanie punktu końcowego, modelu lub asynchronii | Sprawdź identyfikator i ścieżkę |
| 413 | Żądanie jest zbyt duże | Zmniejsz rozmiar kontekstu |
| 429 | Przekroczono prędkość obrotową lub współbieżność | Honor Retry-After |
| 500 | Błąd bramy | Spróbuj ponownie i sprawdź dzienniki |
| 502/503/504 | Przesyłanie strumieniowe niedostępne lub przekroczono limit czasu | Spróbuj ponownie z wykładniczym wycofaniem |
Wymagana płatność
Niewystarczające saldo firmy/konta zwraca HTTP 402 Payment Required w kopercie kompatybilnej z OpenAI:
{
"error": {
"message": "Insufficient account balance.",
"type": "payment_required",
"code": "insufficient_balance"
}
}
Ten sam stabilny powód/kod jest rejestrowany w Historii żądań. A 402 żądanie zostaje odrzucone przed wykonaniem przez dostawcę i nie powinno być automatycznie ponawiane do czasu skorygowania finansowania lub obowiązujących ograniczeń wydatków.
Odrzucenie listy dozwolonych adresów IP
Gdy uwierzytelniony klucz API jest ważny, ale adres źródłowy znajduje się poza efektywną listą dozwolonych interfejsów API osobistych lub organizacji biznesowych, Model Gate odrzuca żądanie przed wykonaniem w górę. Odpowiedzi zgodne z OpenAI korzystają z protokołu HTTP 403 z kodem ip_not_allowed. Odpowiedzi zgodne z Anthropic korzystają z koperty błędów Anthropic z protokołem HTTP 403 I authentication_error. Nie próbuj ponownie z tego samego niedozwolonego źródła; zmień skonfigurowaną listę dozwolonych lub wyślij żądanie z dozwolonego adresu.
Spróbować ponownie 429 Po Retry-After. Spróbować ponownie 500, 502, 503, I 504 do trzech razy z opóźnieniem 1/2/4 sekundy. Nie ponawiaj automatycznie sprawdzania poprawności, uwierzytelniania, salda ani błędów nieznalezionych.
Użyj publicznego identyfikatora żądania z X-Request-ID powiązać odpowiedź z dziennik żądań.