Docs / Mulai
Autentikasi
Kirim API key sebagai token Bearer atau di header x-api-key.
Terakhir diperbarui
API key
API key berbentuk cai_<secret>. Key dibuat di Key di dashboard. Key lengkap hanya tampil sekali saat dibuat; Cent AI hanya menyimpan hash-nya.
Kirim key di salah satu header. Keduanya diterima di semua endpoint model.
| Header | Pemakaian umum |
|---|---|
Authorization: Bearer cai_<secret> | SDK dan tool OpenAI, /v1/chat/completions, /v1/responses, /v1/models |
x-api-key: cai_<secret> | SDK dan tool Anthropic, /v1/messages |
curl https://api.cent-ai.dev/v1/models \
-H "Authorization: Bearer $CENT_AI_KEY"
Bila kedua header dikirim dengan key berbeda, header asli protokol dicoba lebih dulu: x-api-key di /v1/messages, Authorization: Bearer di endpoint lain. Bila key itu tidak valid, header satunya dicoba. Tagihan masuk ke key yang dipakai.
Key tidak valid
Key salah, key yang sudah dicabut, dan key milik akun yang diblokir mendapat respons yang sama, HTTP 401 invalid_api_key:
{"error": {"message": "Invalid API key. Check the key or create a new one in the dashboard.", "type": "authentication_error", "param": null, "code": "invalid_api_key"}}
Key diperiksa paling awal, jadi key salah tetap mendapat 401 walaupun endpoint-nya belum tersedia.
Limit di key
Setiap key bisa punya, semuanya opsional:
- limit harian dan limit bulanan; melewati limit, request dijawab 429
key_limit_exceeded - allowlist IP; alamat lain mendapat 403
ip_not_allowed - allowlist model; model lain mendapat 403
model_not_allowed
Key baru tidak punya limit. Siapa pun yang memegang key tanpa limit bisa menghabiskan seluruh saldo Anda. Limit diperiksa saat request dimulai, jadi request yang sudah berjalan bisa melewati limit.
Setiap key berada di satu project. Project bisa punya budget harian atau bulanan sendiri; bila terlewati, key di project itu dijawab 429 project_budget_exceeded. Key milik project yang diarsipkan dijawab 403 project_archived sampai project dipulihkan.
Mengganti atau mencabut key
Untuk mengganti key, buat key baru, pindahkan aplikasi ke key itu, lalu cabut key lama. Pencabutan berlaku dalam hitungan detik.
Management key
Management key berbentuk cai_mgmt_<secret>. Key ini hanya membaca data pemakaian dan saldo lewat /v1/organization/* dan tidak bisa memanggil model. Management key di endpoint model dijawab 401, dan API key di /v1/organization/* dijawab 401.
Jangan taruh key di browser
API menjawab request lintas origin (Access-Control-Allow-Origin: *), jadi key yang ditaruh di kode frontend akan berfungsi, dan siapa pun yang membuka halaman itu bisa membacanya. Panggil Cent AI dari server Anda, atau beri key untuk browser limit yang ketat.