Developer guide
Kòd erè
Aksyon ak règ pou nouvo tantativ selon kòd estati a
Paj sa a rezime kòd estati pòtay la retounen, siyifikasyon yo ak aksyon pou chak kòd.
Lè upstream lan bay yon kòd 4xx·5xx, nou transmèt kòd sa a jan li ye a; pou lòt ka yo, suiv tablo ki anba a.
Nou bay tou fòm kò erè yo pou de fòma konpatibilite yo, règ pou error.type ki konpatib ak Anthropic, ansanm ak ekran konsole a pou tcheke limit ak itilizasyon.
Kòd estati
| Kòd | Siyifikasyon | Aksyon |
|---|---|---|
| 400 | Erè nan valè demann lan. limit lis modèl ki konpatib ak Anthropic lan pa nan entèval 1~1000, oswa yo te eseye reprann yon repons ki anrejistre avèk GET /responses/{responseId}?stream=true | Korije valè a pou li antre nan entèval la. Konsilte repons ki anrejistre a san stream. |
| 401 | Kle a manke, li ekspire oswa li revoke | Tcheke estati kle a sou paj kle API a, epi verifye non antèt la ak prefiks Bearer la. |
| 403 | Pa gen pèmisyon pou jwenn aksè nan modèl la, limit itilizasyon depase, kredi ensifizan, oswa ou pa pwopriyetè vwa a | error.message ap ede distenge rezon an. Ou ka wè chif yo sou ekran ki nan seksyon tcheke limit ak itilizasyon ki anba a. |
| 404 | Modèl la pa egziste oswa kle sa a pa ka jwenn aksè ladan l (sa gen ladan modèl yo ki pa sipòte ankò), chemen an pa egziste, oswa yon rezilta CleviDrive ki depase peryòd konsèvasyon 3 jou a | Tcheke anvan sa lis modèl ou ka rele yo avèk GET /models. Konpare chemen an avèk tablo ki sou paj Fè apèl API a. |
| 408 · 409 · 413 | Delè upstream lan depase, anbouteyaj, oswa gwosè demann lan depase limit la. Pou chemen vwa·son yo, delè limit la se 5 minit epi limit demann lan se 28 MiB | Si 409 gen Retry-After, tann kantite tan sa a. Pou 413, separe demann lan an plizyè pati. |
| 429 | Lè founisè upstream lan mete yon limit sou vitès la | Si gen Retry-After, suiv li jan li ye a; si pa gen youn, eseye ankò avèk backoff eksponansyèl. |
| 5xx | Erè tanporè pòtay la oswa upstream lan (sa gen ladan 503) | Eseye ankò avèk backoff eksponansyèl. Si sa repete, fè nou konnen sa nan Èd ak Kontak, ansanm ak X-Request-Id. |
Nouvo tantativ
Pòtay la pa kreye pwòp 429 pa li, epi li pa eseye reponn ankò an silans oswa mete repons upstream lan nan yon keu.
Se kliyan an ki jere tann ak nouvo tantativ yo.
| Kòd | Tan pou tann | Apre sa |
|---|---|---|
| 409 | Si gen Retry-After, tan sa a | Voye menm demann lan ankò. |
| 429 | Si gen Retry-After, tan sa a; si pa genyen, backoff eksponansyèl | Voye menm demann lan ankò. |
| 5xx | Backoff eksponansyèl | Si sa repete, kontakte nou. |
| 413 | Pa gen tan pou tann | Divize demann lan. |
Kò erè
Fòm kò erè yo varye selon espesifikasyon yo. Pou erè ki soti nan upstream, nou kenbe sèlman mesaj la, nou netwaye li epi nou voye li; stack la ak chan entèn yo pa transmèt.
Sa a se kò repons pou chemen ki konpatib ak OpenAI.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Sa a se kò repons pou chemen ki konpatib ak Anthropic. error.type detèmine dapre kòd estati a.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Kòd estati | 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 |
| Lòt kòd | api_error |
Verifye limit ak itilizasyon
Chif limit yo varye selon espas travay la. Verifye rezon 403 la nan error.message, epi gade chif yo sou ekran ki anba a.
| Sa pou verifye | Ekran konsole |
|---|---|
| Limit ki aplike nan espas travay mwen | Limit itilizasyon atribye nan apèsi a |
| Ranje plan an pèmèt ak balans lan | Plan ak kredi |
| Itilizasyon reyèl (kantite apèl pa modèl ak pa kle, kredi yo prevwa pou dedwi) | Itilizasyon |
| Estati kle a (si li ekspire oswa anile) | Kle API |