Genel bakış
API kullanımı işlem limitlerine tabidir. Bu limitler, belirli bir süre içindeki istekleri, token'ları veya diğer kullanımları sınırlar.
429 yanıtı, geçici bir işlem limitine, tükenmiş bir ön ödemeli bakiyeye veya harcama ya da 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 varsa error.code değerini okuyun. Faturalandırmayla ilgili hatalarda da daha genel bir error.type değeri olan insufficient_quota kullanılabilir.
| Hata veya kod | Anlamı | Yapılması gereken |
| İstekler veya token'lar için işlem limitine ulaşıldı | İstekler, geçerli bir işlem limitini aşıyor. | İstekleri zamana yayın ve aşağıdaki yeniden deneme önerilerini izleyin. |
| credit_balance_exhausted | Kuruluşun ön ödemeli kredisi kalmadı. | API faturalandırma ayarlarınızdan kredi ekleyin. |
| organization_usage_limit_exceeded | Kuruluş, OpenAI tarafından belirlenen kullanım limitine ulaştı. | Daha yüksek bir kullanım limiti için onay talep edin. |
| organization_spend_limit_exceeded | Kuruluş, uygulanan 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, uygulanan 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 hatalarında yeniden denemek erişimi geri getirmez. Önce bildirilen bakiye veya limit sorununu giderin. Uygulanan harcama limitlerinde yapılan değişikliklerin geçerli olması zaman alabilir.
Harcama limitini değiştirmek için ilgili kuruluş veya proje ayarlarını yönetme izniniz olmalıdır. Erişiminiz yoksa bu ayarları yöneten kişiden yardım isteyin.
Ön ödemeli kredi satın alma işlemleri için Ön ödemeli API faturalandırmasını ayarlama ve yönetme makalesine bakın.
Farklı harcama denetimleri için API harcama limiti kılavuzuna bakın.
Geçerli işlem limitlerini kontrol edin
Mevcut kullanım kademesini ve limitlerini incelemek için kuruluşunuzun Limitler sayfasına gidin.
İşlem limitleri kuruluş ve proje düzeyinde uygulanabilir. Bunlar, kullanıcılara ayrı ayrı tanınan kullanım hakları değildir. Limitler modele göre de değişir ve bazı model aileleri ortak bir limit kullanır.
Hatanın hangi limiti belirttiğini kontrol edin. Örneğin, dakika başına istek sayısı ve dakika başına token sayısı ayrı limitlerdir. Birine ulaşırken diğerinin altında kalabilirsiniz.
Görsel oluşturma API'sinin limitlerini kontrol edin
Görsel oluşturma API'sinin işlem limitleri, modele ve kullanım kademenize bağlıdır. Limitlerini görmek için modeller sayfasında modelinizi seçin.
Kurulum talimatları için görsel oluşturma geliştirici kılavuzuna bakın. Kullanım kademeleri hakkında daha fazla bilgi için API işlem limiti kılavuzuna bakın.
İsteğinizin kullandığı kuruluşu doğrulayın
Birden fazla kuruluşa üyeyseniz isteklerinizin amaçladığınız kuruluşu ve projeyi kullandığını doğrulayın.
API anahtarınız varsayılan bir kuruluş kullanıyorsa varsayılan kuruluş ayarınızı kontrol edin. Kuruluşların faturalandırma düzenlemeleri ve kullanım kademeleri farklı olabilir.
Geçici işlem limiti hatalarını azaltın
İstekleri zamana yayın ve ani yoğunluktan kaçının
Çok sayıda isteği aynı anda göndermek yerine zamana yayın.
İşlem limitleri, gösterilen zaman aralığından daha kısa süreler için de uygulanabilir. Örneğin, dakikada 60 istek limiti, 1 saniyelik aralıklar üzerinden de uygulanabilir. Bu nedenle, ortalama kullanımınız dakika başına limitin altında görünse bile kısa süreli bir istek yoğunluğu hataya yol açabilir.
Uzun prompt'lar ve gereğinden 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ında:
Yanıtta Retry-After üst bilgisinin bulunup bulunmadığını kontrol edin.
Üst bilgi geçerli bir bekleme süresi içeriyorsa yeniden denemeden önce en az bu süre kadar bekleyin.
Üst bilgi yoksa veya geçersizse rastgele sapma içeren üstel geri çekilme yöntemini kullanın: her başarısız denemeden sonra bekleme süresini artırın ve buna kısa, rastgele bir süre ekleyin.
Hem yeniden deneme sayısını hem de yeniden denemelere ayrılan toplam süreyi sınırlayın.
Resmî OpenAI SDK'ları, uygun işlem limiti hatalarında zaten yeniden deneme yapar ve Retry-After varsa burada belirtilen süreye 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 dahil edilir. Aynı isteği sürekli yeniden göndermek sorunun daha uzun sürmesine neden olabilir.
Uygulama önerileri ve örnekler için API işlem limiti kılavuzuna bakın. Üçüncü taraf yeniden deneme kütüphanelerini uygulamanızda kullanmadan önce inceleyin.
Prompt ve çıktı boyutunu gözden geçirin
Prompt'larınızdan gereksiz talimatları, tekrarlanan bağlamı ve örnekleri çıkarın. Düzenlediğiniz prompt'u test ederek hâlâ ihtiyacınız olan sonucu ürettiğini doğrulayın.
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 token'larını da kapsar. Bu nedenle bir akıl yürütme modeli kullanırken her ikisi için de pay bırakın.
Kullanım kademenizi gözden geçirin
Ani istek yoğunluğunu azalttıktan ve token kullanımını gözden geçirdikten sonra hatalar devam ederse limitlerinizi artırma seçenekleri için Limitler sayfanızı kontrol edin.
Kuruluşunuzun toplam kredi alımları Build, Launch ve Grow eşiklerine ulaştıkça ücretli kullanım kademesi otomatik olarak yükselir. Üst kademeler genellikle daha yüksek işlem limitleri sunar. Kademe gereksinimleri için API işlem limiti kılavuzuna bakın.
Onaylanmış aylık kullanım limitiniz, istek ve token işlem limitlerinden ayrıdır. Birinin artırılması, diğerinin de değiştiği anlamına gelmez.
Sorun devam ederse
Destek almadan önce
Hata mesajının tam metnini, varsa hata kodunu, ilgili istek kimliklerini, saat diliminizle birlikte hatanın oluştuğu zamanı ve hesabınızda gösterilen ilgili limiti hazır bulundurun. Daha önce denediğiniz adımları not edin.
OpenAI Destek ekibiyle iletişime geçin
Bildirilen limiti kontrol ettikten sonra sorunu çözemiyorsanız Yardım Merkezi üzerinden OpenAI Destek ekibiyle iletişime geçin. API anahtarlarını veya diğer gizli kimlik doğrulama bilgilerini paylaşmayın.