# Autentikasi dan API key (/id/docs/concepts/authentication)

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](https://console.cheapaimodel.ai/keys) di konsol.

## Cara mengirim key [#sending-the-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`.

<Callout type="warn">
  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.
</Callout>

## Batas key [#key-options]

Untuk mengatur **Batas** sebuah key, klik **Key baru** di halaman [API key](https://console.cheapaimodel.ai/keys) 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 [#one-key-per-app]

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.