Developer guide
Kódy chyb
Postup a pravidla opakování podle stavového kódu
Tato stránka shrnuje stavové kódy vracené bránou, jejich význam a postup pro jednotlivé kódy.
Pokud upstream vrátí kód 4xx nebo 5xx, brána jej předá beze změny; v ostatních případech platí níže uvedená tabulka.
Uvádíme také formát těla chyb pro oba kompatibilní standardy, pravidla pro error.type kompatibilní s Anthropic a obrazovku konzole pro kontrolu limitů a využití.
Stavový kód
| Kód | Význam | Postup |
|---|---|---|
| 400 | Chyba hodnoty požadavku. U parametru limit v seznamu modelů kompatibilních s Anthropic je hodnota mimo rozsah 1–1000 nebo se byl proveden pokus pokračovat ve streamování uložené odpovědi pomocí GET /responses/{responseId}?stream=true | Opravte hodnotu tak, aby spadala do povoleného rozsahu. Uložené odpovědi načítejte bez stream. |
| 401 | Chybějící, prošlý nebo zneplatněný klíč | Na obrazovce API klíčů zkontrolujte stav klíče a ověřte název hlavičky a předponu Bearer. |
| 403 | Bez oprávnění k přístupu k modelu, překročení limitu využití, nedostatek kreditů nebo nejste vlastníkem hlasu | error.message rozlišuje důvod. Číselné hodnoty najdete na obrazovce v níže uvedené části o kontrole limitů a využití. |
| 404 | Model neexistuje nebo k němu tento klíč nemá přístup (včetně modelů, jejichž podpora skončila), neexistující cesta nebo výstup CleviDrive po uplynutí retenční doby 3 dnů | Nejprve pomocí GET /models ověřte seznam modelů, které lze volat. Cestu porovnejte s tabulkou na stránce Volání API. |
| 408 · 409 · 413 | Vypršení časového limitu upstreamu, zahlcení nebo překročení velikosti požadavku. Časový limit pro hlasové a voice cesty je 5 minut a maximální velikost požadavku je 28 MiB | Pokud je u 409 uvedeno Retry-After, počkejte po uvedenou dobu. U kódu 413 požadavek rozdělte. |
| 429 | Případ, kdy upstream poskytovatel uplatní omezení rychlosti | Pokud je uvedeno Retry-After, dodržte jej beze změny; pokud uvedeno není, opakujte požadavek s exponenciálním backoffem. |
| 5xx | Dočasná chyba brány nebo upstreamu (včetně 503) | Opakujte požadavek s exponenciálním backoffem. Pokud problém přetrvává, informujte nás prostřednictvím nápovědy a kontaktního formuláře a uveďte X-Request-Id. |
Opakování
Brána nevytváří vlastní 429 a odpovědi upstreamu ani skrytě neopakuje, ani je nezařazuje do fronty.
Čekání a opakování zajišťuje klient.
| Kód | Doba čekání | Další krok |
|---|---|---|
| 409 | Pokud je k dispozici Retry-After, počkáme po uvedenou dobu | Odešleme stejný požadavek znovu. |
| 429 | Pokud je k dispozici Retry-After, počkáme po uvedenou dobu, jinak použijeme exponenciální backoff | Odešleme stejný požadavek znovu. |
| 5xx | Exponenciální backoff | Pokud se problém opakuje, kontaktujeme podporu. |
| 413 | Bez čekání | Požadavek rozdělíme. |
Tělo chyby
Tělo chyby se liší podle specifikace. Chyby upstreamu předáváme po úpravě pouze jako zprávu; zásobník ani interní pole se nepředávají.
Tělo z kompatibilní trasy OpenAI.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Tělo z kompatibilní trasy Anthropic. error.type se určuje podle stavového kódu.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Stavový kód | error.type |
|---|---|
| 400 | invalid_request_error |
| 401 | authentication_error |
| 403 | permission_error |
| 404 | not_found_error |
| 413 | request_too_large |
| 429 | rate_limit_error |
| 529 | overloaded_error |
| Ostatní kódy | api_error |
Kontrola limitů a využití
Hodnoty limitů se liší podle workspace. Nejprve zkontrolujte důvod chyby 403 v error.message a poté si hodnoty prohlédněte na níže uvedené obrazovce.
| Co zkontrolovat | Obrazovka konzole |
|---|---|
| Limity platné pro můj workspace | Přidělený limit využití v přehledu |
| Rozsah povolený plánem a zůstatek | Plán a kredity |
| Skutečné využití (počet volání podle modelu a klíče, odhadované odečtené kredity) | Využití |
| Stav klíče (zda je expirovaný nebo zneplatněný) | API klíče |