Menu docs

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.

PengaturanFungsiBila tidak terpenuhi
Limit harianPengeluaran maksimum per hari dalam USD429 key_limit_exceeded
Limit bulananPengeluaran maksimum per bulan dalam USD429 key_limit_exceeded
Allowlist IPHanya alamat IP atau rentang CIDR ini yang bisa memakai key403 ip_not_allowed
Allowlist modelHanya ID model ini yang bisa dipakai dengan key403 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:

EventArti
createdKey dibuat
first_usedKey mengirim request pertamanya
new_ipKey dipakai dari alamat IP yang belum pernah dipakai sebelumnya
limit_changedLimit atau allowlist key diubah
revokedKey dicabut

new_ip yang tidak Anda kenali adalah tanda key mungkin bocor.

Mengganti key

Cent AI tidak punya tombol rotasi. Untuk mengganti key:

  1. Buat key baru dengan limit dan allowlist yang sama.
  2. Pindahkan aplikasi ke key baru dan pastikan request berhasil.
  3. 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.