Błędy
Kody błędów HTTP, formaty odpowiedzi i reguły ponawiania prób.
| 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ń.
Błędy po nagłówkach strumienia
SSE może zakończyć się niepowodzeniem po wysłaniu protokołu HTTP200. Odpowiedź zawiera wówczas zdarzenie błędu zgodne z protokołem; historia żądań bramy rejestruje awarię terminala niezależnie od stanu przewodu. Nieznane wiadomości nadrzędne są domyślnie ukryte, zatwierdzone wiadomości mogą zostać ujawnione zgodnie z zasadami administratora, a pełne ujawnienie błędów nadrzędnych jest jawne. Wewnętrzne metadane nadrzędne i tymczasowe surowce pozostają dostępne tylko dla administratora. Brakujące użycie po przerwanym strumieniu jest nieznane/wymaga sprawdzenia, a nie automatycznego oszacowania na podstawie bajtów połączenia. Zachowaj identyfikator żądania i spróbuj ponownie celowo tylko po sprawdzeniu częściowych wyników.