Developer guide
Msimbo wa hitilafu
Hatua na kanuni za kujaribu tena kulingana na msimbo wa hali
Lango hupitisha msimbo huo huo ikiwa upstream itarejesha 4xx·5xx; katika hali nyingine, fuata kanuni zilizo kwenye jedwali hapa chini.
400·401·403·404·413 ni misimbo inayohitaji ombi au mipangilio kurekebishwa, huku 409·429·5xx ikiwa ni misimbo ambayo mteja anapaswa kusubiri kisha kutuma ombi lilelile tena.
Muundo wa maudhui ya hitilafu hutofautiana kulingana na vipimo, na error.type ya njia inayooana na Anthropic huamuliwa na msimbo wa hali.
Sababu ya 403 hutofautishwa kupitia error.message, huku viwango na takwimu za matumizi zikithibitishwa kwenye skrini ya kiweko.
Msimbo wa hali
| Msimbo | Maana | Hatua |
|---|---|---|
| 400 | Thamani ya ombi si sahihi. limit ya orodha ya miundo inayooana na Anthropic iko nje ya 1–1000, au umejaribu kuendelea kutiririsha jibu lililohifadhiwa kwa GET /responses/{responseId}?stream=true. | Rekebisha thamani iwe ndani ya masafa. Pata majibu yaliyohifadhiwa bila stream. |
| 401 | Ufunguo haupo au umeisha muda wake au umebatilishwa. | Angalia hali ya ufunguo kwenye ukurasa wa funguo za API, na uhakikishe jina la kichwa pamoja na kiambishi awali cha Bearer. |
| 403 | Huna ruhusa ya kufikia muundo, umevuka kikomo cha matumizi, huna salio la kutosha, au wewe si mmiliki wa sauti. | Angalia sababu katika error.message, na uthibitishe takwimu kwenye skrini iliyo katika sehemu ya vikomo na matumizi hapa chini. |
| 404 | Muundo haupo au hauwezi kufikiwa kwa ufunguo huu (ikiwemo miundo ambayo haitegemezwi tena). Pia hurejeshwa ikiwa umeita njia isiyopo au umeomba matokeo ya CleviDrive ambayo yamevuka kipindi cha kuhifadhi cha siku 3. | Kwanza angalia orodha ya miundo inayoweza kuitwa kwa GET /models. Linganisha njia hiyo na jedwali lililo kwenye ukurasa wa Kuita API. |
| 408 · 409 · 413 | Muda wa upakiaji wa juu umeisha, kuna msongamano, au ukubwa wa ombi umevuka kikomo. Kikomo cha muda kwa njia za sauti na voice ni dakika 5, na kikomo cha ombi ni 28 MiB. | Ikiwa 409 ina Retry-After, subiri muda huo kisha utume ombi lilelile tena. Kwa 413, gawanya ombi na kulituma kwa sehemu. |
| 429 | Mtoa huduma wa juu ametumia kikomo cha kasi. | Ikiwa kuna Retry-After, subiri muda huo kisha utume tena; ikiwa hakuna, jaribu tena kwa kutumia kurudi nyuma kwa kielelezo. |
| 5xx | Kosa la muda kutoka kwenye lango au mfumo wa juu (ikiwemo 503). | Jaribu tena kwa kutumia kurudi nyuma kwa kielelezo. Ikiwa linaendelea, wasiliana nasi. |
402 hairudishwi. Ukosefu wa salio na kuvuka kikomo cha matumizi vyote hurudishwa kama 403.
Kujaribu tena na kuwasiliana nasi
Lango halitengenezi 429 zake lenyewe, wala halijaribu tena au kuweka kwenye foleni majibu kutoka kwa mfumo wa juu. Kusubiri na kujaribu tena hufanywa na mteja.
Unapowasiliana nasi, toa maelezo kupitia Usaidizi na Wasiliana nasi pamoja na X-Request-Id. Ikiwa hukutuma X-Request-Id, thamani iliyotolewa na seva iko kwenye kichwa cha request-id cha jibu linalooana na Anthropic.
Mwili wa kosa
Muundo wa mwili wa hitilafu hutofautiana kulingana na vipimo. Kwa hitilafu za upstream, tunahifadhi ujumbe pekee na kuuwasilisha baada ya kuupanga; hatuwasilishi stack au sehemu za ndani.
Huu ni mwili wa hitilafu wa njia inayooana na OpenAI.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Huu ni mwili wa hitilafu wa njia inayooana na Anthropic. error.type huamuliwa kulingana na msimbo wa hali kama ilivyo kwenye jedwali hapa chini.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Msimbo wa hali | 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 |
| Misimbo mingine | api_error |
Kukagua viwango na matumizi
Viwango hutofautiana kwa kila nafasi ya kazi. Angalia sababu ya 403 katika error.message, kisha ukague viwango kwenye skrini ifuatayo.
| Mambo ya kukagua | Skrini ya kiweko |
|---|---|
| Kiwango kinachotumika kwenye nafasi ya kazi | Kiwango cha matumizi kilichotengewa katika muhtasari |
| Masafa na salio linaloruhusiwa na mpango | Mpango na salio |
| Matumizi halisi (idadi ya miito kwa kila modeli na ufunguo, salio la makadirio linalokatwa) | Matumizi |
| Hali ya ufunguo (ikiwa umeisha muda au umebatilishwa) | Ufunguo wa API |