Menu docs

Docs / Referensi

Error 4xx

Arti setiap kode 4xx dari Cent AI, penyebab umumnya di tool, dan cara memperbaikinya.

Terakhir diperbarui


Respons 4xx berarti Cent AI menolak request sebelum sampai ke model. Tidak ada yang ditagih. Untuk melihat rinciannya nanti, buka Requests di dashboard dan cari x-request-id dari respons.

400 invalid_request

Body tidak valid untuk endpoint itu, misalnya model atau messages tidak ada, atau JSON tidak bisa dibaca.

Cocokkan body dengan Chat Completions, Responses, atau Messages. Tool yang mengirim satu format ke endpoint lain, misalnya body Anthropic ke /v1/chat/completions, mendapat error ini: periksa base URL di tool.

401 invalid_api_key

"Invalid API key. Check the key or create a new one in the dashboard."

  • Key salah ketik, terpotong saat ditempel, atau diapit spasi.
  • Key sudah dicabut. Buat yang baru di Key.
  • Management key (cai_mgmt_…) dipakai di endpoint model. Pakai API key (cai_…).

402 insufficient_balance

"Your balance is empty. Top up or buy a package in the dashboard."

Saldo yang bisa dipakai untuk model ini nol atau kurang. Top-up atau beli paket budget. Bila Anda punya budget paket tetapi tetap mendapat 402, model itu tidak termasuk paket Anda: pesannya menyebut paket yang dibutuhkan, dan saldo pay-as-you-go berlaku untuk semua model. Lihat Saldo.

403 ip_not_allowed, model_not_allowed, project_archived

  • ip_not_allowed: key punya allowlist IP dan request datang dari alamat lain. Tambahkan alamat itu ke key, atau hapus allowlist.
  • model_not_allowed: key punya allowlist model tanpa model ini. Tambahkan model itu ke key.
  • project_archived: key milik project yang diarsipkan. Pulihkan project agar key-nya bisa dipakai lagi.

404 model_not_found

"The model '{model}' does not exist or is not available."

Pakai nama model persis seperti di daftar GET /v1/models. Bila tool Anda mengisi nama model sendiri, atur manual ke nama dari daftar itu.

413 request_too_large

Body lebih besar dari 32 MiB. Kirim file yang lebih sedikit atau lebih kecil, atau persingkat percakapan.

429 rate_limited

"Rate limit of 600 requests per minute for this key was exceeded. Retry after {n} seconds."

Tunggu sebanyak detik di Retry-After. Agen yang menjalankan banyak tugas paralel di satu key paling sering mengalami ini; bagi pekerjaannya ke beberapa key atau minta batas lebih tinggi ke support. Lihat Rate limit.

429 key_limit_exceeded

"This key reached its {daily|monthly} limit. Raise the limit or wait until {reset_at}."

Limit yang Anda pasang di key sudah tercapai. Naikkan di Key, atau tunggu sampai waktu di pesan.

429 project_budget_exceeded

"This project reached its {daily|monthly} budget. Raise the budget or wait until {reset_at}."

Budget project milik key sudah tercapai. Project lain tetap berjalan. Naikkan budget di Projects, atau tunggu sampai waktu di pesan.

501 not_available_yet

"This endpoint is not available yet."

Endpoint ini belum dibuka. Endpoint chat sudah tersedia. Lihat Error.

Kapan menghubungi support

Bila sebuah error tidak cocok dengan penjelasannya di sini, kirim email ke support@cent-ai.dev dengan x-request-id dari respons. Jangan kirim API key Anda.