Autentikasi dan API key
Cara mengirim API key kamu, dan cara membatasi apa saja yang bisa dilakukan setiap key.
Setiap permintaan membawa salah satu API key kamu. Buat dan kelola key di halaman API key di konsol.
Cara mengirim key
| Endpoint | Header |
|---|---|
| Semua endpoint | Authorization: Bearer sk-... |
/v1/messages (format Anthropic) | x-api-key: sk-... juga bisa |
SDK resmi otomatis memasang header yang benar saat kamu mengisi api_key / apiKey.
Perlakukan key seperti kata sandi. Simpan di variabel lingkungan atau secret manager, jangan pernah di kode sisi klien atau di repositori publik. Kalau key bocor, hapus di konsol lalu buat yang baru.
Batas key
Untuk mengatur Batas sebuah key, klik Key baru di halaman API key di Konsol, atau Ubah di samping key yang sudah ada. Keempat batas masing-masing punya sakelar: kalau mati, berarti tanpa batas; kalau dinyalakan, kamu bisa mengisi nilainya. Perubahan langsung berlaku.
| Batas | Fungsinya |
|---|---|
| Kedaluwarsa | Pilih 7 hari, 30 hari, 90 hari, 1 tahun, atau Atur sendiri untuk memilih tanggal. Key berhenti berfungsi pukul 23:59 waktu setempat pada hari itu, dan permintaan mendapat 401. |
| Batas pengeluaran | Jumlah dalam dolar AS. Begitu key sudah memakai sebanyak ini, key berhenti berfungsi dan permintaan mendapat 401. Saat mengubah key, angka ini adalah sisa yang masih bisa dipakai, dan kalau kamu mengubahnya, sisanya ikut diatur ulang. |
| Model yang diizinkan | Pilih model dari katalog, atau ketik ID model yang tidak ada di daftar, maksimal 50. Panggilan ke model lain mendapat 403. |
| Daftar IP yang diizinkan | Satu alamat IP atau rentang CIDR per baris, maksimal 20. Permintaan dari alamat lain mendapat 403. |
Saat mengubah key, Kedaluwarsa dan Batas pengeluaran tetap seperti sebelumnya kecuali kamu mengubahnya. Di daftar key, kolom Anggaran menunjukkan sisa dan pemakaian tiap key, dan Status menunjukkan Kedaluwarsa atau Anggaran habis begitu key mencapai salah satu batas ini. Batas pengeluaran tidak akan membuat key bisa memakai lebih dari saldo akunmu.
Satu key per aplikasi
Beri setiap aplikasi, lingkungan, atau rekan tim key-nya sendiri. Dengan begitu, kamu bisa melihat pengeluarannya di daftar key, membatasinya dengan batas pengeluaran, dan menghapusnya tanpa mengganggu yang lain.