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
| Kode | HTTP | Arti |
|---|---|---|
invalid_request | 400 | Body request tidak valid |
invalid_api_key | 401 | Key salah, sudah dicabut, atau milik akun yang diblokir |
insufficient_balance | 402 | Tidak ada saldo yang bisa dipakai untuk model ini |
ip_not_allowed | 403 | Request datang dari IP di luar allowlist key |
model_not_allowed | 403 | Model di luar allowlist model key |
project_archived | 403 | Key milik project yang diarsipkan |
model_not_found | 404 | Model tidak ada atau tidak tersedia |
request_too_large | 413 | Body lebih besar dari 32 MiB |
rate_limited | 429 | Melewati batas request per menit key |
key_limit_exceeded | 429 | Key mencapai limit harian atau bulanannya |
project_budget_exceeded | 429 | Project mencapai budget harian atau bulanannya |
not_available_yet | 501 | Endpoint belum dibuka |
internal_error | 500 atau 503 | Error di dalam Cent AI |
upstream_unavailable | 503 | Model sedang tidak tersedia di semua rute |
upstream_rate_limited | 503 | Model sedang terkena rate limit di semua rute |
upstream_timeout | 503 | Model tidak mulai menjawab tepat waktu, atau stream mencapai durasi maksimum |
upstream_error | Status dari model | Model 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
- Error 4xx: masalah di request, key, limit, atau saldo
- Error 5xx: masalah di model atau di Cent AI
- Stream timeout: stream yang berhenti atau tidak pernah mulai
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"}}