Claude API “kredi bakiyesi çok düşük” / 402 insufficient_quota

Bu hatanın kodunuzla hiçbir ilgisi yoktur: anahtarın arkasındaki ön ödemeli bakiye boşalmıştır (veya aylık harcama sınırınız devreye girmiştir). Anthropic Console ile ağ geçitleri arasındaki faturalandırma modellerinin farklarını ve gece 2'de tekrarlanmasını önleyen alarmları burada bulabilirsiniz.

Hata

yanıt (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}}

Nedenler ve çözümler özeti

Neden	Çözüm
Ön ödemeli bakiye gerçekten sıfır	Bakiye yükleyin. Anthropic'te: Console → Plans & billing. Kunavo'da: /app/billing (bakiye hiçbir zaman sona ermez).
Otomatik yükleme kapalı (veya kartın süresi dolmuş)	Otomatik yüklemeyi etkinleştirin / kartı güncelleyin; böylece ani artışlar fark edilmeden bakiyeyi sıfıra tüketmez.
Aylık harcama sınırına ulaşıldı	Harcama meşruysa anahtar veya çalışma alanı başına sınırı yükseltin ya da kaldırın.
Yanlış çalışma alanının anahtarı	Anahtarlar, onları oluşturan çalışma alanının bakiyesinden harcar — finanse edilmiş bir kuruluş, başka bir çalışma alanının anahtarını finanse etmez.

Sorunun bakiye değil, kimlik doğrulama olduğundan emin olun

401 = anahtar sorunu; 400 "credit balance too low" / 402 insufficient_quota = para sorunu. Faturalandırma hatası için anahtarları döndürmeyin — yeni anahtar da aynı boş cüzdanı okur.

Bakiye yükleyin, ardından ucuz bir çağrıyla doğrulayın

Bakiye hem Anthropic'te hem de Kunavo'da hemen uygulanır — yeniden dağıtım gerekmez. Worker'larınızı yeniden etkinleştirmeden önce minimum bir istekle doğrulama yapın:

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?"}]}'

Claude Code'da mı görüyorsunuz?

Claude Code, Console bakiyesi boş olan bir Anthropic API anahtarıyla çalıştığında bu mesajı yazdırır — Pro veya Max oturumu bunun yerine kullanım limitlerine takılır ve bu mesajı hiçbir zaman göstermez. Console bakiyesine para yükleyin veya kullandıkça öde esaslı bir uç noktada çalışmaya devam edin: Claude Code, ANTHROPIC_BASE_URL’i doğrudan okur; dolayısıyla geçiş birkaç ortam değişkeninden ibarettir. Dört model satırını koruyun — Claude Code’un varsayılan modeli ile opus ve sonnet takma adları Anthropic’in en yeni modellerini izler ve sonnet takma adı Sonnet 5.5’i ister; Kunavo bu modeli sunmaz.

~/.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

Bir sonrakini sıradan hâle getirin

Düşük bakiye uyarısı (e-posta) ayarlayın ve sağlayıcınız destekliyorsa makul bir aylık sınırla otomatik yüklemeyi etkinleştirin. Sıfır bakiyede durmak doğrudur — duvarın kendisini değil, duvara çarpmadan önce uyarıyı görmek istersiniz.

Kunavo’da: 402 yanıtını okuyun ya da otomatik yüklemeye bırakın

Kunavo cüzdanının döndürdüğü 402, nedeni makinenin okuyabileceği biçimde bildirir: error.code değeri insufficient_balance’dır, error.balance_usd ve error.needed_usd aradaki farkı verir; error.topup_url ve error.auto_recharge_url ise çözümün önceden seçili olduğu fatura sayfasını açar. Bu iki bağlantının hiçbiri ücret almaz. İsteğe bağlı otomatik yüklemeyi açarsanız, bakiye belirlediğiniz eşiğin altına her düştüğünde cüzdan seçtiğiniz tutar kadar ($10’dan başlayarak ve belirlediğiniz aylık sınır içinde) kendini yükler; böylece reddedilecek bir istek karşılanır — tahsilat başarılı olduğu ve aylık sınırda yer kaldığı sürece. Böyle bir yükleme hâlâ sürerken 402 yanıtı Retry-After taşır: o süreden sonra yeniden deneyin, Retry-After taşımayan bir 402’yi ise yeniden denemeyi bırakın.

Kunavo üzerinden çağrı yapıyorsanız

Kunavo, bakiye sıfıra indiğinde açık bir 402 insufficient_quota hatasıyla çalışmayı durdurur (belirsiz bir 500 hatası vermez), başarısız istekler ücretlendirilmez ve etkin hesaplara, limite ulaşmadan önce kendi harcama hızlarına göre kalan kullanım süresini gösteren düşük bakiye e-postası gönderilir. Bakiye, süresi hiçbir zaman dolmayan ve $10’dan başlayan ön ödemeli bir cüzdandır; /app/billing adresinde kartlarla, Hindistan dışında Apple Pay, Google Pay veya Link ile ya da Stripe’ın para biriminizde sunduğu Pix, WeChat Pay, UPI veya KakaoPay gibi yerel ödeme yöntemleriyle yüklenebilir. Belirli bir yüklemenin ne kadar dayanacağı tamamen hangi modeli kullandığınıza bağlıdır ve model başına ücretler şu bölümde yer alır: Anthropic Claude API fiyat listesi.

Sık sorulan sorular

Bakiye yükledim — neden hâlâ hatayı alıyorum?

Anahtarı oluşturan aynı hesaba/çalışma alanına bakiye yüklediğinizi ve asıl engelin aylık harcama sınırı olmadığını kontrol edin. Bakiyenin uygulanması hem Anthropic'te hem de Kunavo'da anlıktır.

Claude API'nin ücretsiz katmanı var mı?

Hayır — Anthropic her API çağrısını ilk tokenden itibaren ücretlendirir (Claude.ai tüketici planları API kredisinden ayrıdır). Ağ geçitleri de kullandıkça öde modeliyle çalışır; Kunavo, liste fiyatının altında ücretlerle $10 yüklemeyle başlar.

Claude Code'da “Credit balance is too low” — ancak Pro için ödeme yapıyorum. Neden?

Çünkü Claude Code aboneliğinizi değil, bir API anahtarını kullanıyor. ANTHROPIC_API_KEY veya ANTHROPIC_AUTH_TOKEN ayarlı olduğu sürece Claude Code anahtarı ücretlendirir ve Pro veya Max oturumunu beklemeye alır; bu anahtar da ayrı bir ön ödemeli Console bakiyesinden harcar. Hangi kimlik bilgisinin etkin olduğunu görmek için /status komutunu çalıştırın; plana dönmek için değişkeni kaldırın veya anahtarın bakiyesine yükleme yapın.

OpenClaw “API provider returned a billing error” diyor — aynı şey mi?

Evet. Bu, OpenClaw'un model sağlayıcısından gelen faturalandırma reddi için kullandığı ifadedir: API anahtarının kredileri tükenmiştir veya bakiye yetersizdir. O sağlayıcıya bakiye yükleyin ya da OpenClaw'u başka bir sağlayıcıya geçirin — aşağıdaki ilgili kılavuzlar seçenekleri karşılaştırır.

İlgili kılavuzlar

Hata anlamlarına ilişkin daha fazla bilgi hata referansı bölümünde; anahtar almak kayıt ve kimlik doğrulama kılavuzu üzerinden bir dakika sürer.