Genel bakış
API kullanımı işlem limitlerine tabidir. Bu limitler, belirli bir süre içindeki istekleri, tokenları veya diğer kullanımları sınırlar.
429 yanıtı; geçici bir işlem limitine, tükenmiş ön ödemeli bakiyeye ya da harcama veya kullanım limitine işaret edebilir. Yeniden denemeden veya faturalandırma ayarlarınızı değiştirmeden önce hata ayrıntılarını kontrol edin.
Nedeni belirleyin
Hata mesajını ve sağlanmışsa error.code değerini okuyun. Faturalandırmayla ilgili hatalarda daha genel olan error.type değeri insufficient_quota yine kullanılabilir.
| Hata veya kod | Anlamı | Yapılması gerekenler |
| İstek veya token işlem limitine ulaşıldı | İstekler, geçerli bir işlem limitini aşıyor. | İsteklerin hızını ayarlayın ve aşağıdaki yeniden deneme rehberini izleyin. |
| credit_balance_exhausted | Kuruluşun ön ödemeli kredisi kalmamış. | API faturalandırma ayarlarınızdan kredi ekleyin. |
| organization_usage_limit_exceeded | Kuruluş, OpenAI tarafından atanan kullanım limitine ulaştı. | Onaylanan kullanım limitinin yükseltilmesini talep edin. |
| organization_spend_limit_exceeded | Kuruluş, zorunlu harcama limitine ulaştı. | Limiti artırın veya kaldırın ya da aylık sıfırlamayı bekleyin. |
| project_spend_limit_exceeded | Proje, zorunlu harcama limitine ulaştı. | Proje limitini artırın veya kaldırın ya da aylık sıfırlamayı bekleyin. |
Faturalandırma, harcama veya kota hatasında yeniden denemek erişimi geri getirmez. Önce bildirilen bakiye veya limit sorununu giderin. Zorunlu harcama limitlerinde yapılan değişikliklerin uygulanması zaman alabilir.
Harcama limitini değiştirmek için ilgili kuruluş veya proje ayarlarını yönetme izni gerekir. Erişiminiz yoksa bu ayarları yöneten kişiden yardım isteyin.
Ön ödemeli kredi satın alma hakkında bilgi için: Ön ödemeli API faturalandırmasını ayarlama ve yönetme.
Farklı harcama kontrolleri hakkında bilgi için API harcama limiti kılavuzuna bakın.
Geçerli işlem limitlerini kontrol edin
Kuruluşunuzun mevcut kullanım kademesini ve limitlerini incelemek için Limitler sayfasına gidin.
İşlem limitleri kuruluş ve proje düzeyinde uygulanabilir. Bunlar kullanıcılara özel haklar değildir. Limitler modele göre de değişir ve bazı model aileleri ortak bir limiti paylaşır.
Hatanın hangi limiti belirttiğini kontrol edin. Örneğin dakika başına istek ve dakika başına token limitleri birbirinden ayrıdır. Birinin altında kalırken diğerine ulaşabilirsiniz.
İsteğinizde kullanılan kuruluşu doğrulayın
Birden fazla kuruluşa üyeyseniz isteklerinizde amaçlanan kuruluşun ve projenin kullanıldığını doğrulayın.
API anahtarınız varsayılan bir kuruluş kullanıyorsa varsayılan kuruluş ayarınızı kontrol edin. Farklı kuruluşların faturalandırma düzenlemeleri ve kullanım kademeleri farklı olabilir.
Geçici işlem limiti hatalarını azaltın
İsteklerin hızını ayarlayın ve ani artışlardan kaçının
Çok sayıda isteği aynı anda göndermek yerine zamana yayın.
İşlem limitleri, gösterilen aralıktan daha kısa süreler üzerinden uygulanabilir. Örneğin dakikada 60 istek limiti, 1 saniyelik dönemler üzerinden de uygulanabilir. Bu nedenle ortalama kullanımınız dakika başına limitin altında görünse bile kısa süreli ani bir artış hatayı tetikleyebilir.
Uzun promptlar ve gereksiz ölçüde yüksek çıktı tokenı sınırları da token işlem limiti hatalarına yol açabilir.
Bir süre bekleyip yeniden deneyin
Geçici işlem limiti hataları için:
Yanıtta Retry-After üstbilgisi olup olmadığını kontrol edin.
Üstbilgi geçerli bir bekleme süresi içeriyorsa yeniden denemeden önce en az bu süre kadar bekleyin.
Üstbilgi yoksa veya geçersizse rastgele gecikme eklenmiş üstel geri çekilme kullanın: Başarısız olan her denemeden sonra bekleme süresini artırın ve kısa, rastgele bir gecikme ekleyin.
Hem yeniden deneme sayısını hem de yeniden denemelere ayrılan toplam süreyi sınırlayın.
Resmî OpenAI SDK'ları, yeniden denenebilecek işlem limiti hatalarında bunu zaten yapar ve mevcutsa Retry-After üstbilgisine uyar. Başka bir yeniden deneme döngüsü eklemeden önce bu denemeleri hesaba katın.
Başarısız istekler de dakika başına uygulanan limitlere dâhildir. Aynı isteği sürekli yeniden göndermek sorunun uzamasına neden olabilir.
Uygulama rehberi ve örnekler için API işlem limiti kılavuzuna bakın. Üçüncü taraf bir yeniden deneme kitaplığını uygulamanızda kullanmadan önce inceleyin.
Prompt ve çıktı boyutunu inceleyin
Promptlarınızdan gereksiz talimatları, yinelenen bağlamı ve örnekleri kaldırın. Gözden geçirilen promptun ihtiyacınız olan sonucu hâlâ ürettiğini doğrulamak için test edin.
Uç noktanızın ve modelinizin desteklediği çıktı tokenı parametresini kullanın:
Chat Completions, max_completion_tokens parametresini kullanır.
Responses, max_output_tokens parametresini kullanır.
İsteğin gerektirdiğinden çok daha yüksek bir sınır belirlemekten kaçının. Bu parametreler görünür çıktının yanı sıra akıl yürütme tokenlarını da kapsar. Bu nedenle akıl yürütme modeli kullanırken her ikisini de hesaba katın.
Kullanım kademenizi inceleyin
Ani istek artışlarını azaltıp token kullanımını inceledikten sonra hatalar devam ederse limitlerinizi artırmak için kullanabileceğiniz seçenekleri Limitler sayfasında kontrol edin.
API harcamaları arttıkça OpenAI, bir kuruluşu otomatik olarak daha yüksek bir kullanım kademesine geçirebilir. Bu genellikle çoğu modelde işlem limitlerini artırır.
Onaylanan aylık kullanım limitiniz, istek ve token işlem limitlerinden ayrıdır. Birindeki artış, diğerinin de değiştiğinin onayı olarak görülmemelidir.
Sorun devam ederse
Destek ekibine iletmeden önce
Hata mesajının tamamını, varsa hata kodunu, ilgili istek kimliklerini, saat diliminizle birlikte hatanın gerçekleştiği zamanı ve hesabınızda gösterilen ilgili limiti hazır bulundurun. Daha önce denediğiniz adımları not edin.
OpenAI Destek Ekibi ile iletişime geçin
Bildirilen limiti kontrol ettikten sonra sorunu çözemiyorsanız Yardım Merkezi üzerinden OpenAI Destek Ekibi ile iletişime geçin. API anahtarlarını veya diğer kimlik doğrulama sırlarını paylaşmayın.