# Error (/id/docs/concepts/errors)

Kode status HTTP, isi body error, dan error mana yang sebaiknya dicoba ulang.



Error dikembalikan dengan status non-2xx dan body JSON berformat OpenAI:

```json
{
  "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-codes]

| 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](/id/docs/concepts/models#sampling-limits). |
| `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](/id/docs/concepts/rate-limits).                                                                     |
| `503` dengan `code: model_not_found`                      | Tidak ada penyedia model yang melayani ID model ini.                                                                                                                                                                                            | Cek ID model di [katalog](/id/models).                                                                                                                             |
| `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 [#request-ids]

Setiap respons punya header `X-Oneapi-Request-Id`, dan pesan error juga mencantumkan ID itu. Sertakan ID ini saat kamu menghubungi [tim bantuan](/id/docs/support).