Platform

Batas dan aturan kunci

Batasi setiap kunci API sesuai kegunaannya: jumlah pengeluaran, laju permintaan, model yang digunakan, asal akses, dan masa berlaku. Atur saat membuat kunci, atau kapan saja melalui Kunci API → Edit.

Aturan

Aturan	Jika batas terlampaui	Error
Anggaran bulanan (USD)	Permintaan ditolak hingga bulan berikutnya (UTC)	`402 key_budget_exceeded`
Anggaran harian (USD)	Ditolak hingga tengah malam UTC	`402 key_daily_budget_exceeded`
Batas laju (permintaan per menit)	Ditolak sementara, dengan `retry-after`	`429 rate_limit_exceeded`
Kedaluwarsa	Kunci tidak lagi berfungsi	`401 expired_api_key`
Model yang diizinkan	Model lain ditolak	`403 model_not_allowed`
Alamat IP yang diizinkan	Permintaan dari alamat lain ditolak	`403 ip_not_allowed`

Permintaan yang ditolak tidak pernah dikenai biaya. Anggaran memperhitungkan dana yang dicadangkan untuk permintaan yang sedang berjalan pada kunci tersebut (lihat Penagihan), sehingga permintaan yang berpotensi melampaui anggaran ditolak sebelum dimulai, dan respons yang mencapai batas saat sedang berjalan akan berhenti dengan error anggaran terkait. Perubahan berlaku di semua tempat dalam 15 detik. Saldo ruang kerja Anda berlaku untuk semua kunci: jika saldo tidak cukup untuk membiayai permintaan, permintaan tersebut mendapat 402 insufficient_quota.

Model yang diizinkan

Pilih model apa pun, baik teks, gambar, maupun video. Kunci yang dibatasi, misalnya, hanya untuk gpt-6-sol dan gemini-3.7-flash tidak bisa memanggil model lain, dan perutean cerdas hanya menggunakan alternatif dari daftar tersebut. Mengizinkan Zurelay Auto memungkinkan kunci menggunakan model apa pun yang dipilih Auto.

Alamat IP yang diizinkan

Alamat tunggal dan rentang CIDR, IPv4 dan IPv6, hingga 100 per kunci. Alamat yang diperiksa adalah alamat asal permintaan Anda di internet (jika melalui proxy atau NAT, alamat itulah yang diperiksa).

Contoh

203.0.113.7          one address
198.51.100.0/24      a range of 256 addresses
2001:db8::/32        an IPv6 range

Platform serverless dan beberapa layanan cloud mengirim permintaan dari alamat yang berubah-ubah. Gunakan rentang alamat keluar yang dipublikasikan penyedia Anda, atau biarkan akses IP tanpa pembatasan pada kunci tersebut dan andalkan aturan lainnya.

Penerapan anggaran

Berikan kunci dan anggaran tersendiri untuk setiap aplikasi atau lingkungan, agar satu loop yang tak terkendali tidak menguras saldo.
Anggaran harian membatasi dampak bug pada hari yang sama; anggaran bulanan membatasi tagihan.
Halaman Kunci API menampilkan pengeluaran setiap kunci hari ini dan bulan ini di samping anggarannya.

Ada pertanyaan, atau ada yang kurang? Tanyakan kepada tim dukungan kami dan kami akan menjawab lewat email, biasanya dalam satu menit.