Developer guide
Kod ralat
Tindakan dan peraturan percubaan semula mengikut kod status
Halaman ini menyusun kod status yang dikembalikan oleh get laluan, maksudnya, serta tindakan mengikut kod.
Jika huluan mengembalikan 4xx·5xx, kod tersebut disampaikan 그대로, manakala kes lain mengikut jadual di bawah.
Bentuk isi ralat bagi dua spesifikasi keserasian, peraturan Anthropic yang serasi dengan error.type, serta skrin konsol untuk menyemak had dan penggunaan turut diterangkan.
Kod status
| Kod | Maksud | Tindakan |
|---|---|---|
| 400 | Ralat nilai permintaan. limit bagi senarai model yang serasi dengan Anthropic berada di luar julat 1~1000, atau percubaan dibuat untuk menyambung respons tersimpan melalui GET /responses/{responseId}?stream=true | Betulkan nilai supaya berada dalam julat. Dapatkan respons tersimpan tanpa stream. |
| 401 | Kunci tiada atau telah tamat tempoh·dibatalkan | Semak status kunci pada skrin kunci API, kemudian periksa nama pengepala dan awalan Bearer. |
| 403 | Tiada kebenaran untuk mengakses model, had penggunaan melebihi, kredit tidak mencukupi, atau bukan pemilik suara | error.message membezakan sebabnya. Nilai boleh dilihat pada skrin dalam bahagian menyemak had dan penggunaan di bawah. |
| 404 | Model tiada atau tidak boleh diakses dengan kunci ini (termasuk model yang sokongannya telah tamat), laluan tiada, atau hasil CleviDrive yang telah melebihi tempoh penyimpanan 3 hari | Semak dahulu senarai model yang boleh dipanggil melalui GET /models. Bandingkan laluan dengan jadual pada halaman Membuat panggilan API. |
| 408 · 409 · 413 | Masa huluan tamat, kesesakan, atau saiz permintaan melebihi had. Berdasarkan laluan suara·voice, had masa ialah 5 minit dan had permintaan ialah 28 MiB | Jika 409 mempunyai Retry-After, tunggu selama tempoh tersebut. Untuk 413, bahagikan permintaan dan hantar secara berasingan. |
| 429 | Apabila penyedia huluan mengenakan had kadar | Jika Retry-After tersedia, ikutinya seperti yang diberikan; jika tiada, cuba semula dengan backoff eksponen. |
| 5xx | Ralat sementara pada get laluan atau huluan (termasuk 503) | Cuba semula dengan backoff eksponen. Jika berulang, maklumkan melalui bantuan dan pertanyaan bersama X-Request-Id. |
Percubaan semula
Get laluan tidak menghasilkan 429 sendiri, dan juga tidak mencuba semula respons huluan secara senyap atau memasukkannya ke dalam baris gilir.
Menunggu dan percubaan semula dilakukan oleh klien.
| Kod | Masa menunggu | Kemudian |
|---|---|---|
| 409 | Jika terdapat Retry-After, tunggu tempoh tersebut | Hantar semula permintaan yang sama. |
| 429 | Jika terdapat Retry-After, tunggu tempoh tersebut; jika tiada, gunakan backoff eksponen | Hantar semula permintaan yang sama. |
| 5xx | Backoff eksponen | Jika berulang, hubungi kami. |
| 413 | Tiada masa menunggu | Bahagikan permintaan. |
Isi kandungan ralat
Bentuk isi kandungan ralat berbeza mengikut spesifikasi. Ralat huluan disampaikan selepas diringkaskan dengan hanya meninggalkan mesej; tindanan dan medan dalaman tidak disertakan.
Ini ialah isi kandungan bagi laluan yang serasi dengan OpenAI.
{
"error": {
"message": "API key is required.",
"type": "invalid_request_error"
}
}Ini ialah isi kandungan bagi laluan yang serasi dengan Anthropic. error.type ditentukan berdasarkan kod status.
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "..."
},
"request_id": "rqid..."
}| Kod 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 |
| Kod lain | api_error |
Semak had dan penggunaan
Angka had berbeza mengikut ruang kerja. Semak sebab 403 melalui error.message, kemudian lihat angka tersebut pada skrin di bawah.
| Perkara yang perlu disemak | Skrin konsol |
|---|---|
| Had yang dikenakan pada ruang kerja saya | Had penggunaan yang diperuntukkan dalam Gambaran keseluruhan |
| Julat yang dibenarkan oleh pelan dan baki | Pelan dan kredit |
| Penggunaan sebenar (jumlah panggilan mengikut model dan kunci, anggaran kredit yang ditolak) | Penggunaan |
| Status kunci (sama ada telah tamat tempoh atau dibatalkan) | Kunci API |