Developer guide
Kode kesalahan
Tindakan lan aturan nyoba maneh miturut kode status
Kaca iki ngringkes kode status sing diwenehake gateway, tegesé, lan tindakan kanggo saben kode.
Yen upstream menehi 4xx·5xx, kode kasebut diterusake apa anané, dene ing kasus liyane manut tabel ing ngisor iki.
Wangun isi kesalahan saka rong spesifikasi kompatibilitas, aturan Anthropic kompatibel error.type, uga layar konsol kanggo mriksa watesan lan panggunaan uga diterangake.
Kode status
| Kode | Teges | Tindakan |
|---|---|---|
| 400 | Kesalahan nilai panjalukan. limit ing dhaptar model Anthropic kompatibel metu saka rentang 1~1000, utawa nyoba nerusake respons sing disimpen nganggo GET /responses/{responseId}?stream=true | Ndandani nilai supaya ana ing rentang sing bener. Respons sing disimpen dijupuk tanpa stream. |
| 401 | Kunci ora ana utawa wis kadaluwarsa·dicabut | Priksa status kunci ing layar API key, banjur priksa jeneng header lan prefiks Bearer. |
| 403 | Ora nduwèni idin ngakses model, watesan panggunaan wis ngluwihi, kredit kurang, utawa dudu pemilik voice | error.message nerangake bedané saben sebab. Nilai angka bisa dideleng ing layar ing bagean mriksa watesan lan panggunaan ing ngisor iki. |
| 404 | Model ora ana utawa ora bisa diakses nganggo kunci iki (kalebu model sing dhukungané wis rampung), jalur ora ana, utawa asil CleviDrive sing wis ngluwihi wektu panyimpenan 3 dina | Priksa luwih dhisik dhaptar model sing bisa ditelpon nganggo GET /models. Bandhingake jalur karo tabel ing kaca Nglakokaké panggilan API. |
| 408 · 409 · 413 | Wates wektu upstream wis entek, rame, utawa ukuran panjalukan ngluwihi wates. Wates wektu kanggo jalur audio·voice yaiku 5 menit, lan wates panjalukan yaiku 28 MiB | Yen 409 ngemot Retry-After, enteni suwéné wektu kasebut. Kanggo 413, bagi panjalukan dadi sawetara bagean. |
| 429 | Panyedhiya upstream ngetrapaké watesan kacepetan | Yen ana Retry-After, tindakna apa anané; yen ora ana, coba maneh nganggo exponential backoff. |
| 5xx | Kesalahan sauntara ing gateway utawa upstream (kalebu 503) | Coba maneh nganggo exponential backoff. Yen bola-bali, laporaké liwat Bantuan lan Kontak bebarengan karo X-Request-Id. |
Nyoba maneh
Gateway ora nggawe 429 dhéwé, uga ora kanthi meneng-meneng nyoba maneh respons upstream utawa nyelehake ing antrean.
Ngenteni lan nyoba maneh ditindakake déning klien.
| Kode | Wektu ngenteni | Sabanjure |
|---|---|---|
| 409 | Yen ana Retry-After, enteni wektu kasebut | Kirim maneh panjaluk sing padha. |
| 429 | Yen ana Retry-After, enteni wektu kasebut; yen ora ana, gunakake backoff eksponensial | Kirim maneh panjaluk sing padha. |
| 5xx | Backoff eksponensial | Yen bola-bali, hubungi dhukungan. |
| 413 | Ora perlu ngenteni | Pecah panjaluk dadi sawetara bagean. |
Isi kesalahan
Wangun isi kesalahan beda-beda gumantung spesifikasi. Kesalahan saka upstream diringkes lan diterusake kanthi mung nyisakake pesen; stack utawa kolom internal ora diterusake.
Iki isi kanggo jalur sing kompatibel karo OpenAI.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Iki isi kanggo jalur sing kompatibel karo Anthropic. error.type ditemtokake adhedhasar kode status.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Kode status | 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 |
| Kode liyane | api_error |
Priksa watesan lan panggunaan
Angka watesan beda-beda kanggo saben workspace. Priksa sebab 403 liwat error.message, banjur delengen angka kasebut ing layar ing ngisor iki.
| Sing kudu dipriksa | Layar konsol |
|---|---|
| Watesan sing ditrapake ing workspaceku | Watesan panggunaan sing dialokasikan ing Ringkesan |
| Rentang sing diidinake plan lan saldo | Plan lan kredit |
| Panggunaan nyata (jumlah panggilan miturut model lan kunci, perkiraan kredit sing dipotong) | Panggunaan |
| Status kunci (apa wis kadaluwarsa utawa dicabut) | Kunci API |