OpenAI “Mevcut kotanızı aştınız” (insufficient_quota) — beklemek neden hiçbir şeyi düzeltmez?

Bu, backoff ile düzeltilemeyen 429 hatasıdır. insufficient_quota, hesabınızda harcanabilir kredi olmadığı anlamına gelir — istek herhangi bir model çalışmadan önce reddedilmiştir ve faturalandırma değişene kadar reddedilmeye devam eder. Hangi faturalandırma durumunda olduğunuzu nasıl doğrulayacağınız ve bunu dakikalar içinde nasıl çözeceğiniz aşağıdadır.

Hata

yanıt (HTTP 429)

{
  "error": {
    "message": "You exceeded your current quota, please check your plan and billing details. For more information on this error, read the docs: https://platform.openai.com/docs/guides/error-codes/api-errors.",
    "type": "insufficient_quota",
    "param": null,
    "code": "insufficient_quota"
  }
}

Nedenler ve çözümler özeti

Neden	Çözüm
Ön ödemeli kredi bakiyesi $0	API ön ödemelidir: Ayarlar → Faturalandırma bölümünden kredi satın alın veya otomatik yeniden yüklemeyi etkinleştirin. Kayıtlı bir kart, kredi satın alınana kadar tek başına hiçbir şey eklemez.
Ücretsiz deneme kredileri sona erdi veya harcandı	Deneme kredileri kullanılmamış olsa bile (genellikle 3 ay sonra) sona erer. Çözüm aynıdır: bir ödeme yöntemi ekleyin ve kredi satın alın.
Aylık bütçe sınırına ulaşıldı	Sınırlar altında kendiniz belirlediğiniz bir bütçe, aşıldığında ayın geri kalanı boyunca istekleri engeller. Sınırı artırın veya ayın yenilenmesini bekleyin.
Anahtar, bütçesi olmayan bir projeye veya kuruluşa ait	sk-proj- anahtarları harcamayı kendi projelerinden yapar; bir projenin kuruluş sınırından daha düşük kendi sınırı olabilir. Yalnızca kuruluş toplamını değil, kontrol panelinde anahtarın projesini de kontrol edin.

Bunun kota mı, hız sınırlaması mı olduğunu doğrulayın

error.type değerini okuyun. rate_limit_exceeded bir dakika içinde kendiliğinden temizlenir ve backoff uygulanmasını gerektirir; insufficient_quota kendiliğinden temizlenmez ve yeniden denemek yalnızca gürültü oluşturur. Emin değilseniz 60 saniye sonra bir kez yeniden deneyin: aynı mesajla hâlâ 429 alıyorsanız sorun faturalandırmadır.

Anahtarın gerçekten harcadığı kredi bakiyesini kontrol edin

platform.openai.com → Ayarlar → Faturalandırma bölümünde kredi bakiyesine bakın. Sıfır veya negatifse kredi satın alın. Ardından aylık bütçe sınırı için Ayarlar → Sınırlar'ı ve — sk-proj- anahtarları için — sahibi olan projenin kendi kullanım sınırlarını kontrol edin. Bu üçünün her biri bağımsız olarak bu hatayı üretebilir.

Yalnızca olayı değil, tekrarlanmasını durdurun

Yoğun bir hafta sonunun üretimi durdurmaması için makul bir eşikle otomatik yeniden yüklemeyi etkinleştirin ve istekler başarısız olmaya başlamadan önce yaklaşan sınırları öğrenmek için bütçe uyarısını (yalnızca kesin sınırı değil) ayarlayın.

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

Kunavo aynı ön ödemeli modeli kullanır; dolayısıyla dürüst karşılaştırma mekanizmayla değil, cüzdanın etki alanıyla ilgilidir: tek bir Kunavo bakiyesi GPT ve Claude'u birlikte kapsar, token başına fiyatlandırılır ve başarısız istekler hiçbir zaman ücretlendirilmez. Kunavo'nun kendi bakiyesi tükendiğinde insufficient_quota koduyla 402 alırsınız (OpenAI SDK hata işlemenin taşınabilmesi için bilerek aynı kod kullanılır) — bakiye yüklemek bunu anında temizler ve aylık sınırları kaldırmak için başka bir işlem gerekmez. Çözüm için bütçe mi ayırıyorsunuz? OpenAI'ın resmi liste fiyatlarıyla birlikte güncel token başına GPT ücretlerimiz şu sayfadadır: GPT API fiyat listesi.

Sık sorulan sorular

Kredi kartı ekledim — neden hâlâ insufficient_quota alıyorum?

Çünkü API doğrudan kartı değil, ön ödemeli kredileri harcar. Kart eklemek yalnızca satın alma işlemini etkinleştirir; yine de kredi satın almanız veya otomatik yeniden yüklemeyi açmanız gerekir. Bakiye pozitife çıktıktan bir veya iki dakika içinde hata temizlenir.

insufficient_quota kendiliğinden düzelir mi?

Yalnızca bir durumda: ay yenilendiğinde sıfırlanan aylık bütçe sınırında. Sıfır bakiye ve süresi dolmuş deneme durumları, kredi satın alana kadar devam eder. Her iki durumda da yeniden deneme döngüleri yardımcı olmaz; istek herhangi bir model çalışmadan önce reddedilir.

Başarısız 429 istekleri herhangi bir maliyete yol açar mı?

Hayır — OpenAI bunları çıkarım başlamadan önce reddeder; Kunavo'da da başarısız istekler hiçbir zaman ücretlendirilmez. Maliyet kesintidir; bu nedenle otomatik yeniden yükleme ile bütçe uyarısı, tek başına kesin bir sınırdan daha etkilidir.

İ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.