Developer guide
Hibakód
Teendők és újrapróbálkozási szabályok állapotkódonként
Ez az oldal összefoglalja a gateway által visszaadott állapotkódokat és azok jelentését, valamint a kódonkénti teendőket.
Ha az upstream 4xx·5xx kódot ad vissza, azt a kódot változatlanul továbbítjuk; egyéb esetekben az alábbi táblázat az irányadó.
Ismertetjük továbbá a két kompatibilitási szabvány hibaválaszának formátumát és az Anthropic-kompatibilis error.type szabályait, valamint a konzol képernyőit, ahol a limitek és a használat ellenőrizhető.
Állapotkód
| Kód | Jelentés | Teendő |
|---|---|---|
| 400 | Érvénytelen kérési érték. Az Anthropic-kompatibilis modellek listájának limit értéke kívül esik az 1–1000 tartományon, vagy a GET /responses/{responseId}?stream=true kéréssel megpróbált egy mentett választ folytatni. | Javítsa az értéket úgy, hogy a tartományon belül legyen. A mentett választ stream nélkül kérje le. |
| 401 | Hiányzó, lejárt vagy visszavont kulcs | Ellenőrizze a kulcs állapotát az API-kulcsok oldalán, valamint ellenőrizze a fejléc nevét és a Bearer előtagot. |
| 403 | Nincs jogosultság a modell eléréséhez, túllépte a használati limitet, nincs elegendő kredit, vagy nem a voice tulajdonosa | Az error.message megkülönbözteti az okokat. A számértékeket az alábbi, limitek és használat ellenőrzése című szakasz képernyőin tekintheti meg. |
| 404 | A modell nem létezik, vagy ezzel a kulccsal nem érhető el (beleértve a már nem támogatott modelleket is), az útvonal nem létezik, vagy a CleviDrive kimenet megőrzési ideje, azaz 3 nap, lejárt | Először a GET /models segítségével ellenőrizze a meghívható modellek listáját. Az útvonalat vesse össze az API-hívások oldalon található táblázattal. |
| 408 · 409 · 413 | Upstream időtúllépés, túlterheltség vagy a kérés méretének túllépése. A hang- és voice-útvonalak esetén az időkorlát 5 perc, a kérés maximális mérete pedig 28 MiB | Ha a 409 válasz Retry-After fejlécet tartalmaz, várjon az abban megadott ideig. 413 esetén ossza fel a kérést több részre. |
| 429 | Az upstream szolgáltató sebességkorlátozást alkalmaz | Ha van Retry-After, kövesse változtatás nélkül; ha nincs, exponenciális visszalépéssel próbálkozzon újra. |
| 5xx | A gateway vagy az upstream átmeneti hibája (beleértve az 503-at is) | Próbálkozzon újra exponenciális visszalépéssel. Ha a hiba ismétlődik, jelezze a súgón és a kapcsolatfelvételi csatornán keresztül az X-Request-Id megadásával. |
Újrapróbálkozás
A gateway nem hoz létre saját 429-es választ, és nem próbálja meg észrevétlenül újra elküldeni az upstream válaszát, illetve nem helyezi sorba.
A várakozást és az újrapróbálkozást a kliens végzi.
| Kód | Várakozási idő | Ezután |
|---|---|---|
| 409 | Ha van Retry-After, ennyi ideig várunk | Újraküldjük ugyanazt a kérést. |
| 429 | Ha van Retry-After, ennyi ideig várunk, ellenkező esetben exponenciális visszalépést alkalmazunk | Újraküldjük ugyanazt a kérést. |
| 5xx | Exponenciális visszalépés | Ha ismétlődik, érdeklődjön. |
| 413 | Nincs várakozás | A kérést részekre bontjuk. |
Hib törzse
A hibatörzs formátuma specifikációnként eltérő. A felfelé továbbított hibákból csak az üzenetet hagyjuk meg, megtisztítjuk, és továbbítjuk; a verem és a belső mezők nem kerülnek továbbításra.
Az OpenAI-kompatibilis útvonal törzse.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Az Anthropic-kompatibilis útvonal törzse. Az error.type értékét az állapotkód határozza meg.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Állapotkó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 |
| Egyéb kódok | api_error |
Korlátok és használat ellenőrzése
A korlátok értékei munkaterületenként eltérnek. Ellenőrizze a 403 okát az error.message mezőben, majd tekintse meg az értékeket az alábbi képernyőn.
| Ellenőrizendő | Konzol képernyője |
|---|---|
| A munkaterületemre vonatkozó korlát | Az áttekintésben szereplő kiosztott használati korlát |
| A csomag által engedélyezett tartomány és egyenleg | Csomag és kreditek |
| Tényleges használat (modellenkénti és kulcsonkénti hívásszám, várhatóan levont kreditek) | Használat |
| Kulcs állapota (lejárt vagy visszavont-e) | API-kulcs |