Error
Kode status HTTP, isi body error, dan error mana yang sebaiknya dicoba ulang.
Error dikembalikan dengan status non-2xx dan body JSON berformat OpenAI:
{
"error": {
"message": "Invalid token (request id: 2026100912391754811973...)",
"type": "new_api_error",
"code": ""
}
}Tentukan penanganan error berdasarkan status HTTP (dan error.code kalau tidak kosong). message ditujukan untuk dibaca manusia dan bisa berubah.
Error dari penyedia model yang muncul setelah permintaanmu diterima bisa datang dalam format penyedia itu sendiri; di /v1/messages formatnya adalah format Anthropic, { "type": "error", "error": { "type": "...", "message": "..." } }. Kedua format sama-sama berisi error.message.
Kode status
| Status | Artinya | Yang perlu dilakukan |
|---|---|---|
400 | Format permintaan tidak valid. | Perbaiki body permintaan. |
400 dengan code: invalid_parameter_error di kimi-k3 | Model ini hanya menerima nilai sampling tetap, dan client kamu mengirim nilai lain, biasanya default seperti temperature 0.7 atau top_p 0.9. Pesannya menyebut parameternya: Parameter 'temperature'=0.7 is not supported for kimi-k3 model. | Jangan kirim temperature dan top_p, atau atur temperature 1 dan top_p 0.95. Lihat Batasan parameter sampling. |
401 | Key tidak disertakan, tidak valid, sudah kedaluwarsa, atau anggarannya sudah habis. | Cek key di konsol. |
403 | Key tidak diizinkan untuk panggilan ini (daftar model atau IP yang diizinkan), atau saldomu tidak cukup. | Sesuaikan opsi key atau top up saldo. |
429 | Terlalu banyak permintaan. | Coba lagi dengan exponential backoff. Lihat Batas permintaan. |
503 dengan code: model_not_found | Tidak ada penyedia model yang melayani ID model ini. | Cek ID model di katalog. |
500, 502, 503, 504 | Gateway atau penyedia model gagal memproses permintaan. | Coba lagi dengan backoff. |
Permintaan yang ditolak dengan 4xx sebelum sampai ke model tidak dikenai biaya.
ID permintaan
Setiap respons punya header X-Oneapi-Request-Id, dan pesan error juga mencantumkan ID itu. Sertakan ID ini saat kamu menghubungi tim bantuan.