Menu docs

Docs / Referensi

Error

Setiap kode error yang dikembalikan Cent AI, status HTTP-nya, dan tempat membaca lebih lanjut.

Terakhir diperbarui


Bentuk error

Error memakai format endpoint yang Anda panggil.

{"error": {"message": "Invalid API key.", "type": "authentication_error", "param": null, "code": "invalid_api_key"}}

Di format OpenAI, field code menyebut nama error. Di format Anthropic, type error mengikuti status HTTP dan pesannya menjelaskan yang terjadi. Setiap respons, termasuk error, punya header x-request-id; ID yang sama ada di halaman Requests di dashboard.

Urutan pemeriksaan

Sebelum request sampai ke model, Cent AI memeriksa dengan urutan ini: body request, key, apakah project key diarsipkan, apakah endpoint tersedia, allowlist IP dan model key, nama model, rate limit, limit pengeluaran key, budget project, dan saldo. Pemeriksaan pertama yang gagal menentukan error-nya. Request yang ditolak di sini tidak ditagih.

Semua kode

KodeHTTPArti
invalid_request400Body request tidak valid
invalid_api_key401Key salah, sudah dicabut, atau milik akun yang diblokir
insufficient_balance402Tidak ada saldo yang bisa dipakai untuk model ini
ip_not_allowed403Request datang dari IP di luar allowlist key
model_not_allowed403Model di luar allowlist model key
project_archived403Key milik project yang diarsipkan
model_not_found404Model tidak ada atau tidak tersedia
request_too_large413Body lebih besar dari 32 MiB
rate_limited429Melewati batas request per menit key
key_limit_exceeded429Key mencapai limit harian atau bulanannya
project_budget_exceeded429Project mencapai budget harian atau bulanannya
not_available_yet501Endpoint belum dibuka
internal_error500 atau 503Error di dalam Cent AI
upstream_unavailable503Model sedang tidak tersedia di semua rute
upstream_rate_limited503Model sedang terkena rate limit di semua rute
upstream_timeout503Model tidak mulai menjawab tepat waktu, atau stream mencapai durasi maksimum
upstream_errorStatus dari modelModel menolak request, misalnya karena parameter yang tidak didukung

Cent AI tidak pernah mengembalikan HTTP 502 atau 504; kegagalan model kembali sebagai 503 dengan salah satu kode di atas.

Per status

Endpoint yang belum dibuka

Endpoint video, suara, transkripsi, dan embeddings dijawab 501 dan tidak ditagih. Endpoint gambar sudah dibuka; lihat Gambar.

{"error": {"message": "This endpoint is not available yet.", "type": "invalid_request_error", "code": "not_available_yet"}}