Docs / Panduan
Mengamankan API key
Atur limit pengeluaran dan allowlist di setiap key, pantau aktivitas key, lalu ganti atau cabut key.
Terakhir diperbarui
Setup Anda
Mengisi YOUR_API_KEY di kode halaman ini. Key hanya ada di tab ini: tidak dikirim dan tidak disimpan.
Cara key disimpan
API key berbentuk cai_<secret>. Secret-nya acak, 256 bit. Cent AI menampilkan key lengkap sekali, saat dibuat, lalu hanya menyimpan hash SHA-256-nya. Tidak ada yang bisa membaca ulang key itu dari dashboard atau API, termasuk Cent AI. Daftar key hanya menampilkan petunjuk pendek seperti cai_k3F9aQ.
Bila key hilang, buat key baru.
Key baru tidak punya limit
Key baru tidak punya limit. Siapa pun yang memegang key tanpa limit bisa menghabiskan seluruh saldo Anda. Dashboard memperingatkan saat Anda membuat key tanpa limit; pembuatan key tidak diblokir.
Beri setiap key limit sekecil yang dibutuhkan. Pakai satu key per aplikasi, perangkat, atau lingkungan, agar setiap key bisa dibatasi dan dicabut sendiri-sendiri.
Limit di key
Atur di Key saat membuat key, atau ubah belakangan. Semuanya opsional.
| Pengaturan | Fungsi | Bila tidak terpenuhi |
|---|---|---|
| Limit harian | Pengeluaran maksimum per hari dalam USD | 429 key_limit_exceeded |
| Limit bulanan | Pengeluaran maksimum per bulan dalam USD | 429 key_limit_exceeded |
| Allowlist IP | Hanya alamat IP atau rentang CIDR ini yang bisa memakai key | 403 ip_not_allowed |
| Allowlist model | Hanya ID model ini yang bisa dipakai dengan key | 403 model_not_allowed |
Pengaturan yang kosong berarti tanpa batas untuk pengaturan itu.
Limit pengeluaran memakai periode UTC: hari dimulai pukul 00:00 UTC, dan bulan dimulai pada tanggal 1 pukul 00:00 UTC. Pesan 429 menyebut kapan limit direset:
{"error": {"message": "This key reached its daily limit. Raise the limit or wait until 2026-10-28T00:00:00Z.", "type": "rate_limit_error", "param": null, "code": "key_limit_exceeded"}}
Limit diperiksa saat request dimulai. Request yang sudah berjalan saat limit tercapai diselesaikan dan ditagih penuh, jadi pengeluaran bisa sedikit melewati limit.
Setiap key juga punya rate limit 600 request per menit, lihat Rate limit. Project milik key bisa punya budget sendiri di atas limit key, lihat Project dan budget.
Pantau aktivitas key
Setiap key punya log aktivitas di Key:
| Event | Arti |
|---|---|
created | Key dibuat |
first_used | Key mengirim request pertamanya |
new_ip | Key dipakai dari alamat IP yang belum pernah dipakai sebelumnya |
limit_changed | Limit atau allowlist key diubah |
revoked | Key dicabut |
new_ip yang tidak Anda kenali adalah tanda key mungkin bocor.
Mengganti key
Cent AI tidak punya tombol rotasi. Untuk mengganti key:
- Buat key baru dengan limit dan allowlist yang sama.
- Pindahkan aplikasi ke key baru dan pastikan request berhasil.
- Cabut key lama.
Key lama tetap bekerja sampai Anda mencabutnya, jadi peralihan bisa dilakukan tanpa jeda layanan.
Mencabut key
Cabut key di Key. Pencabutan berlaku dalam hitungan detik dan tidak bisa dibatalkan. Setelah itu, request dengan key tersebut dijawab HTTP 401 invalid_api_key, sama dengan key yang salah.
Bila key bocor: cabut dulu, lalu buat key pengganti dan periksa Requests serta aktivitas key untuk pemakaian yang tidak Anda kenali.
Jauhkan key dari kode dan browser
- Baca key dari variabel lingkungan atau penyimpanan rahasia, bukan dari kode sumber.
- Jangan taruh key di kode frontend. Endpoint model menjawab request lintas origin, jadi siapa pun yang membuka halaman itu bisa menyalin key. Panggil Cent AI dari server Anda, atau beri key untuk browser limit yang ketat.
- Jangan tempel key di issue, chat, atau tangkapan layar.
export CENT_AI_KEY="YOUR_API_KEY"
Management key
Management key cai_mgmt_<secret> hanya membaca saldo dan pemakaian lewat Usage API. Key ini tidak bisa memanggil model, dan API key tidak bisa membaca Usage API. Management key juga hanya tampil sekali dan disimpan sebagai hash. Buat dan cabut management key di Pengaturan; pencabutan berlaku dalam hitungan detik.