Claude API “credit balance is too low” / 402 insufficient_quota

Kesalahan ini tidak ada hubungannya dengan kode Anda: saldo prabayar di balik kunci kosong (atau batas pengeluaran bulanan Anda telah tercapai). Berikut perbedaan model penagihan antara Anthropic Console dan gateway, serta alarm yang mencegahnya terulang pada pukul 2 pagi.

Error

respons (HTTP 400 / 402)

// Anthropic Console (HTTP 400):
{"type":"error","error":{"type":"invalid_request_error",
 "message":"Your credit balance is too low to access the Anthropic API..."}}

// OpenAI-compatible gateways, e.g. Kunavo (HTTP 402):
{"error":{"message":"Wallet balance is too low for this request. Top up at https://kunavo.com/app/billing",
 "type":"insufficient_quota","code":"insufficient_quota","param":null}}

Ringkasan penyebab dan perbaikan

Penyebab	Perbaikan
Saldo prabayar benar-benar nol	Isi saldo. Di Anthropic: Console → Plans & billing. Di Kunavo: /app/billing (saldo tidak pernah kedaluwarsa).
Isi ulang otomatis nonaktif (atau kartunya kedaluwarsa)	Aktifkan isi ulang otomatis / perbarui kartu agar lonjakan penggunaan tidak menghabiskan saldo hingga nol tanpa disadari.
Batas pengeluaran bulanan tercapai	Naikkan atau hapus batas per kunci / per ruang kerja jika pengeluaran tersebut sah.
Kunci dari ruang kerja yang salah	Kunci menggunakan saldo dari ruang kerja yang menerbitkannya — organisasi yang memiliki dana tidak mendanai kunci dari ruang kerja lain.

Pastikan ini masalah saldo, bukan autentikasi

401 = masalah kunci; 400 "credit balance too low" / 402 insufficient_quota = masalah dana. Jangan mengganti kunci untuk kesalahan penagihan — kunci baru tetap membaca dompet kosong yang sama.

Isi saldo, lalu verifikasi dengan satu pemanggilan murah

Saldo berlaku segera di Anthropic dan Kunavo — tidak perlu melakukan redeploy. Verifikasi dengan permintaan minimal sebelum mengaktifkan kembali worker Anda:

verify.sh

curl -s https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":8,"messages":[{"role":"user","content":"ok?"}]}'

Melihatnya di Claude Code?

Claude Code menampilkan pesan ini saat berjalan menggunakan kunci API Anthropic yang saldonya di Console kosong — login Pro atau Max justru akan mencapai batas penggunaan dan tidak pernah menampilkan pesan ini. Isi saldo Console, atau lanjutkan bekerja pada endpoint pay-as-you-go: Claude Code membaca ANTHROPIC_BASE_URL secara native, sehingga perpindahannya cukup dengan beberapa variabel lingkungan. Pertahankan keempat baris model — default Claude Code serta alias opus dan sonnet-nya mengikuti model terbaru Anthropic, dan alias sonnet meminta Sonnet 5.5, yang tidak disediakan Kunavo.

~/.zshrc

export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Buat kejadian berikutnya membosankan

Atur peringatan saldo rendah melalui email dan, jika penyedia Anda mendukungnya, aktifkan isi ulang otomatis dengan batas bulanan yang wajar. Penagihan fail-closed adalah hal yang benar — Anda hanya perlu menerima peringatan sebelum menabrak batas, bukan setelahnya.

Di Kunavo: baca respons 402, atau biarkan terisi ulang otomatis

Respons 402 dari dompet Kunavo menyatakannya dalam bentuk yang bisa dibaca mesin: error.code bernilai insufficient_balance, error.balance_usd dan error.needed_usd menunjukkan selisihnya, serta error.topup_url dan error.auto_recharge_url membuka halaman tagihan dengan solusi yang sudah dipilihkan — kedua tautan itu tidak menagih apa pun. Jika isi ulang otomatis opsional diaktifkan, dompet akan terisi sendiri sebesar jumlah yang Anda pilih, mulai dari $10 dan dalam batas bulanan yang Anda tetapkan, setiap kali saldo turun di bawah ambang Anda, sehingga permintaan yang semestinya ditolak tetap dilayani — selama penagihannya berhasil dan batas bulanan masih menyisakan ruang. Selama isi ulang itu masih berjalan, 402 membawa Retry-After: coba lagi setelah waktu itu, dan berhenti mencoba ulang 402 yang tidak membawanya.

Jika Anda melakukan panggilan melalui Kunavo

Kunavo berhenti dengan aman saat saldo nol dan mengembalikan 402 insufficient_quota yang eksplisit (tidak pernah 500 yang samar), permintaan yang gagal tidak ditagihkan, dan akun aktif menerima email saldo rendah dengan perkiraan durasi berdasarkan laju penggunaan mereka sendiri sebelum saldo habis. Saldo adalah dompet prabayar mulai dari $10 yang tidak pernah kedaluwarsa, diisi ulang di /app/billing menggunakan kartu, Apple Pay, Google Pay, atau Link di luar India, atau menggunakan metode lokal yang ditampilkan Stripe dalam mata uang Anda seperti Pix, WeChat Pay, UPI, atau KakaoPay. Seberapa jauh pengisian saldo tertentu dapat digunakan sepenuhnya bergantung pada model yang Anda pilih, dan tarif per model tersedia di Daftar harga Claude API Anthropic.

Pertanyaan umum

Saya sudah mengisi saldo — mengapa saya masih menerima kesalahan?

Periksa bahwa Anda mendanai akun/ruang kerja yang sama dengan yang menerbitkan kunci, dan pastikan batas pengeluaran bulanan bukan penyebab sebenarnya. Penerapan saldo sendiri berlangsung segera di Anthropic dan Kunavo.

Apakah API Claude memiliki tingkat gratis?

Tidak — Anthropic menagihkan setiap pemanggilan API sejak token pertama (paket konsumen Claude.ai terpisah dari kredit API). Gateway juga menggunakan pay-as-you-go; Kunavo mulai dari pengisian $10 dengan tarif di bawah harga resmi.

“Credit balance is too low” di Claude Code — tetapi saya membayar Pro. Mengapa?

Karena Claude Code menggunakan kunci API, bukan langganan Anda. Selama ANTHROPIC_API_KEY atau ANTHROPIC_AUTH_TOKEN ditetapkan, Claude Code menagihkan kunci tersebut dan menangguhkan login Pro atau Max, sementara kunci itu menggunakan saldo Console prabayar yang terpisah. Jalankan /status untuk melihat kredensial yang aktif; hapus variabel tersebut untuk kembali ke paket, atau isi saldo kunci.

OpenClaw mengatakan “API provider returned a billing error” — apakah itu hal yang sama?

Ya. Itu adalah istilah OpenClaw untuk penolakan penagihan dari penyedia model: kunci API kehabisan kredit atau memiliki saldo yang tidak mencukupi. Isi saldo penyedia tersebut, atau alihkan OpenClaw ke penyedia lain — panduan terkait di bawah membandingkan pilihannya.

Panduan terkait

Detail semantik error lainnya tersedia di referensi error; mendapatkan kunci hanya perlu satu menit melalui pendaftaran dan panduan autentikasi.