Keamanan kunci API AI & kontrol biaya
Lindungi beban kerja AI dengan kunci terpisah, kuota, masa berlaku, batas model, daftar IP yang diizinkan, kebijakan perutean, rotasi, dan atribusi biaya yang dapat diaudit.

Kunci API AI sebaiknya mewakili satu batas beban kerja, bukan seluruh organisasi selamanya. Kunci yang terpisah membuat akses, kuota, perutean, rotasi, dan catatan penggunaan lebih mudah dikendalikan tanpa mengekspos satu kredensial ke berbagai aplikasi yang tidak berkaitan.
Kunci API Modelflare dapat menggabungkan tanggal kedaluwarsa, kuota terbatas atau tanpa batas, batas model, daftar IP yang diizinkan, dan kebijakan perutean. Kontrol ini paling efektif jika dirancang bersama, bukan baru ditambahkan setelah terjadi insiden.
Mulai dengan satu kunci per beban kerja
Buat kunci terpisah untuk setiap batas yang memerlukan akses atau pencatatan biaya tersendiri, misalnya:
- API produksi dan worker latar belakang;
- pengembangan dan CI;
- agen coding atau alat lokal;
- aplikasi yang digunakan pelanggan;
- kontraktor sementara atau migrasi;
- beban kerja batch berbiaya tinggi.
Gunakan nama yang menjelaskan lingkungan dan tujuan, seperti prod-support-agent atau dev-evaluation. Nama yang jelas membuat catatan permintaan dan keputusan rotasi mudah dipahami tanpa mengungkap rahasianya.
Jauhkan rahasia dari kode yang terlihat oleh klien
Simpan kunci lengkap di pengelola rahasia sisi server atau variabel lingkungan yang terlindungi. Jangan menaruhnya di:
- JavaScript browser atau paket aplikasi seluler yang dapat diperiksa pengguna;
- kontrol sumber, image container, tangkapan layar, atau tiket;
- event analitik, pelacak error, riwayat shell, atau log aplikasi;
- URL, query string, atau contoh perintah yang disalin dengan nilai asli.
Untuk aplikasi browser, kirim permintaan melalui backend yang mengautentikasi pengguna dan menyimpan kunci Modelflare. Jika kunci mungkin bocor, buat kunci pengganti, pindahkan beban kerja, verifikasi traffic pada kunci baru, lalu cabut kunci lama.
Gunakan kuota dan masa berlaku sebagai batas yang independen
Kuota kunci yang terbatas menetapkan batas penggunaan yang tegas pada kunci tersebut. Tanggal kedaluwarsa membatasi berapa lama kredensial tetap valid. Keduanya mengatasi risiko yang berbeda:
| Kontrol | Tujuan utama |
|---|---|
| Kuota terbatas | Membatasi jumlah penggunaan yang dapat dikaitkan dengan kunci |
| Kuota tanpa batas | Menghindari batas di tingkat kunci; kredit akun dan kebijakan lain tetap berlaku |
| Masa berlaku | Mengakhiri akses setelah waktu yang ditentukan |
| Nonaktifkan atau cabut | Langsung menghentikan akses baru |
Kunci untuk pengembangan, kontraktor, dan evaluasi biasanya perlu memiliki kuota terbatas sekaligus masa berlaku. Kunci produksi mungkin memerlukan kuota kunci yang lebih besar atau tanpa batas, tetapi tetap mendapat manfaat dari atribusi beban kerja yang terpisah dan rencana rotasi.
Kuota bukan pengganti batas konkurensi atau kontrol percobaan ulang di klien. Lonjakan permintaan dapat menghabiskan sisa kuota dengan cepat, dan kegagalan berulang dapat menimbulkan permintaan tambahan.
Batasi model jika cakupan beban kerjanya sempit
Batas model mencegah kunci meminta model di luar kumpulan yang dimaksudkan. Hal ini mengurangi penggunaan model yang tidak kompatibel atau ternyata mahal secara tidak sengaja, serta memberikan batas 403 yang lebih jelas ketika klien meminta sesuatu yang seharusnya tidak dapat diaksesnya.
Selaraskan daftar model yang diizinkan dengan endpoint. Kunci yang dapat menampilkan sebuah model tetap memerlukan klien dan protokol yang mendukung format permintaan model tersebut. Tinjau kontrak terkini di Model & Harga, alih-alih menyalin ID model ke dokumen kebijakan yang berlaku jangka panjang.
Tambahkan aturan IP hanya jika jalur jaringan stabil
Daftar IP yang diizinkan (allowlist) mencocokkan IP klien yang teramati oleh Modelflare dengan alamat individual atau rentang CIDR yang dikonfigurasi pada kunci. Fitur ini berguna untuk server dengan jalur keluar (egress) yang sudah diketahui, tetapi dapat memutus traffic ketika:
- beban kerja cloud mengganti alamat NAT keluar;
- permintaan berpindah melalui proxy atau gateway baru;
- jalur IPv4 dan IPv6 berbeda;
- developer berpindah jaringan;
- CIDR yang dikonfigurasi lebih luas atau lebih sempit dari yang dimaksudkan.
Verifikasi jalur egress yang sebenarnya sebelum mengaktifkan pembatasan, siapkan jalur rotasi darurat, dan jangan anggap daftar IP yang diizinkan sebagai pengganti perlindungan rahasia.
Pilih perutean biasa atau pintar secara sengaja
| Jenis kunci | Perilaku perutean | Paling sesuai untuk |
|---|---|---|
| Kunci API biasa | Satu grup utama yang eksplisit ditambah grup cadangan berurutan opsional | Beban kerja yang memerlukan urutan rute dan kebijakan grup yang pasti |
| Kunci API pintar (Smart API Key) | Mengevaluasi grup yang memenuhi syarat bagi akun dengan strategi seimbang, prioritas stabilitas, atau prioritas harga terendah | Beban kerja yang menginginkan pemilihan rute otomatis yang lebih luas |
Kedua jenis kunci tetap mengirim model dan protokol yang diminta. Kebijakan perutean memilih grup yang memenuhi syarat; kebijakan itu tidak menjamin bahwa setiap grup mendukung setiap model atau fitur. Daftar cadangan pada kunci biasa harus diuji sesuai urutannya. Kunci API pintar harus dievaluasi dengan kebutuhan latensi, harga, dan kompatibilitas yang nyata sebelum digunakan di produksi.
Untuk perilaku yang lebih rinci, baca Perutean API AI yang andal.
Rotasi tanpa gangguan yang sebenarnya dapat dihindari
Gunakan rotasi yang tumpang tindih:
- Buat kunci baru dengan pembatasan yang sama seperti yang direncanakan.
- Simpan kunci tersebut di sistem rahasia aplikasi.
- Deploy kredensial baru tanpa menghapus kredensial lama.
- Verifikasi akses model dan satu permintaan nyata.
- Pastikan catatan penggunaan baru muncul di bawah kunci baru.
- Hapus kunci lama dari setiap deployment dan tugas otomatisasi.
- Nonaktifkan atau hapus kunci lama.
- Pantau permintaan tak terduga yang menggunakan kredensial yang sudah dipensiunkan.
Jika kunci sedang disalahgunakan, cabut terlebih dahulu dan terima gangguan yang terkendali. Prosedur tumpang tindih ditujukan untuk rotasi terencana, bukan untuk membiarkan paparan berlanjut.
Hubungkan kebijakan kunci dengan peninjauan biaya
Isolasi di tingkat kunci membuat peninjauan biaya dapat ditindaklanjuti. Filter log penggunaan berdasarkan kunci, lalu bandingkan model, grup, penggunaan input dan output, status, percobaan ulang, dan biaya. Kuota terbatas dapat menghentikan penggunaan lebih lanjut, tetapi catatan permintaanlah yang menjelaskan apa yang menghabiskannya.
Lihat Pelacakan biaya API AI untuk proses peninjauan yang dapat diulang.
Daftar periksa kunci API
- Satu kunci untuk setiap aplikasi, lingkungan, atau beban kerja yang memiliki penanggung jawab.
- Tidak ada rahasia di kode browser, repositori, log, URL, atau tangkapan layar.
- Kuota terbatas dan masa berlaku untuk penggunaan sementara atau eksperimen.
- Pembatasan model untuk beban kerja yang cakupannya sempit.
- Aturan IP hanya untuk jalur egress yang stabil dan sudah diverifikasi.
- Urutan cadangan yang eksplisit pada kunci biasa atau strategi pintar yang dipilih secara sengaja.
- Rotasi diuji sebelum kunci lama dihapus.
- Penggunaan dan biaya ditinjau per kunci setelah setiap perubahan kebijakan.
Pertanyaan umum
Apakah kunci tanpa batas menghapus semua batas pengeluaran?
Tidak. Kunci tanpa batas hanya menghapus batas kuota di tingkat kunci. Kredit akun, harga model, kebijakan grup, batas permintaan, dan kontrol layanan lainnya tetap berlaku.
Bisakah beberapa kunci melewati batas laju?
Belum tentu. Batas dapat berlaku di tingkat akun, grup model, atau rute. Buat kunci untuk akses dan atribusi, bukan sebagai cara mengakali batas laju yang belum diverifikasi.
Apakah daftar IP yang diizinkan sudah cukup jika kunci bocor?
Tidak. Aturan jaringan membatasi dari mana kunci dapat digunakan, tetapi jalur jaringan dapat berubah dan konfigurasi bisa saja keliru. Rotasi kredensial yang terekspos, dan tetap lindungi rahasia saat disimpan maupun saat deployment.