Arti error insufficient quota (saldo habis) di API AI dan cara mengatasinya
403Key valid, tapi saldo atau batas pemakaian key habis.
Langkah perbaikan di bawah berlaku untuk key dari OpenAI, Anthropic, Google maupun gateway. Bagian terakhir menjelaskan pesan dan solusinya di Ezkielyna API.
Dicek · Sumber: dokumentasi Ezkielyna API · Gagal = Gratis · halaman status
Artinya
Server mengenali key-mu, tapi menolak request karena tidak ada saldo atau batas pemakaian sudah tercapai. Kode HTTP-nya tidak seragam: ada yang memakai 403, 402, 400, bahkan 429.
Di OpenAI, insufficient_quota muncul sebagai HTTP 429, sama dengan rate limit. Bacalah isi pesannya, bukan hanya kodenya: menunggu tidak akan membantu kalau saldonya habis.
Contoh pesan yang muncul
Teksnya bisa sedikit berbeda antar versi aplikasi dan SDK. Bagian yang ditulis N, M atau nama-model diganti angka atau nama sungguhan.
- OpenAI (HTTP 429)
You exceeded your current quota, please check your plan and billing details. (code: insufficient_quota) - Anthropic (HTTP 400)
Your credit balance is too low to access the Anthropic API. - Gateway New API (HTTP 403)
user quota is not enough / token quota is not enough
Penyebab umum
- Saldo prabayar habis, atau kredit gratis sudah kedaluwarsa.
- Batas pemakaian per key (budget atau kuota key) tercapai, walaupun saldo akun masih ada.
- Key dibuat di proyek atau organisasi lain yang saldonya kosong.
- Pembayaran baru belum diproses atau saldo belum dimasukkan ke akun yang dipakai key itu.
Cara memperbaiki, langkah demi langkah
- Bedakan saldo akun dan kuota key. Cek saldo akun di dashboard, lalu cek apakah key punya batas pemakaian sendiri. Kalau saldo ada tapi key tetap ditolak, naikkan atau hapus batas key.
- Pastikan key dari akun yang benar. Kalau punya beberapa akun atau proyek, cek bahwa key berasal dari akun yang baru diisi.
- Isi saldo, lalu tes lagi. Setelah top up, tunggu pembayaran terkonfirmasi dan tes dengan satu request kecil.
- Pasang pengaman. Atur batas per key dan pantau log pemakaian supaya saldo tidak habis tiba-tiba oleh agent atau skrip yang berputar.
Di Ezkielyna API
- Menurut dokumentasi Ezkielyna API, 403 insufficient quota berarti saldo Wallet kosong atau batas kuota key tercapai (token quota is not enough). Isi saldo di ezkielyna.store lalu tukarkan kodenya di menu Wallet, atau naikkan kuota key di API Keys.
- API Credit dibayar dengan QRIS (DANA, GoPay, OVO, m-banking), USDT atau Binance Pay. Saldo tidak kedaluwarsa.
- Bonus pendaftaran hanya untuk model grup Standard. Kalau saldo masih bonus dan kamu memanggil Claude atau GPT, top up dulu.
- Setiap request tercatat di menu Log beserta biayanya, jadi kamu bisa melihat model atau aplikasi mana yang menghabiskan saldo.
Alat bantu: isi saldo API Credit · cara beli API key · Cek API Key
Pertanyaan umum
Saya sudah top up OpenAI tapi masih insufficient_quota.
Cek apakah key berasal dari organisasi dan proyek yang sama dengan saldo yang diisi, dan apakah proyek itu punya batas pemakaian sendiri.
Bisa isi saldo API tanpa kartu kredit?
Untuk Ezkielyna API bisa, dengan QRIS, USDT atau Binance Pay. Ini saldo Ezkielyna API, bukan saldo akun OpenAI atau Anthropic.
In English
"Insufficient quota" means the key is valid but the account balance or the key's own spending limit is used up. Status codes differ by provider (OpenAI returns 429 with code insufficient_quota, Anthropic 400 "credit balance is too low", New API gateways 403). On Ezkielyna: top up API Credit (QRIS, USDT, Binance Pay), redeem in Wallet, or raise the key quota.