Hız Sınırları ve Hatalar
Sınırlar ve her durum kodunun anlamı.
Bir 429 birkaç katmandan gelebilir:
- Ücretsiz model üst sınırımız: kullanıcı ve ücretsiz model başına dakikada 1 istek.
- Üst kaynak sınırları: ücretsiz bir modelin arkasındaki sağlayıcı kendi üst sınırına takıldı.
- Bazı ücretsiz havuzlarda günlük token bütçeleri, UTC gece yarısı sıfırlanır.
- Çok büyük promptların tetiklediği dakika başına token sınırları.
- Paralel isteklerde kullanıcı başına eşzamanlılık sınırı.
Ücretli modellerin UnoRouter tarafından uygulanan hız sınırı yoktur.
Dakikada 1 istek sınırı devreye girdiğinde standart hız sınırı başlıkları alırsınız:
HTTP/1.1 429 Too Many Requests
Retry-After: 38
X-RateLimit-Limit: 1
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1783198478Retry-After, sabit 60 değil, pencerenizde kalan saniyedir. Mesaj, sınırı olmayan ücretli modeli adlandırır.
Bazı ücretli modeller istek boyutu sınırıyla ücretsiz sunulur. Aşırı büyük promptlar 413 döndürür: Request body too large for gpt-4.1 model. Max size: 8000 tokens.
Sınır yalnızca ücretsiz rota için geçerlidir. Ücretli model tam uzunlukta promptları kabul eder.
Hatalar OpenAI hata biçiminde JSON döndürür. code kararlı bir tanımlayıcıdır. Her mesajın sonuna bir istek id'si eklenir:
{
"error": {
"message": "Model \"gpt-5.5-typo\" is not offered here. Check the model name for typos, or switch to a model from our supported list. (request id: 20260705...)",
"type": "new_api_error",
"code": "model_not_found"
}
}Destek taleplerinde istek id'sini belirtin. İsteğinizi loglarda bulmayı sağlar.
Anahtarınızı veya temel URL'yi hâlâ ayarlıyorsanız şu sayfayla başlayın: Hızlı başlangıç
Gerçekten karşılaşacağınız durum kodları:
| Kod | Anlamı | Ne yapmalı |
|---|---|---|
400 | Geçersiz istek: hatalı parametre veya moderasyonun engellediği bir prompt. | İsteği düzeltin. Değiştirmeden tekrar denemek yine başarısız olur. |
401 | Eksik, geçersiz, süresi dolmuş veya devre dışı anahtar. | Authorization başlığını ve Tokens page bölümünü kontrol edin. |
402 | Bu anahtarın kendi harcama limiti tükendi. | Anahtarın limitini yükseltin veya yeni bir anahtar oluşturun. |
403 | Bakiye boş, model bu anahtar için izinli değil ya da IP izin listesinde değil. | Bakiye yükleyin veya anahtarın model ve IP kısıtlamalarını kontrol edin. |
413 | İstek, modelin ücretsiz deneme boyut sınırını aşıyor. | Prompt'u kısaltın veya ücretli modele geçin. |
429 | Bir hız sınırı tetiklendi (aşağıdaki türlere bakın). | Retry-After saniyesi kadar bekleyin, ardından yeniden deneyin veya model değiştirin. |
500 | Bizim tarafımızda veya upstream sağlayıcıda bir şey başarısız oldu. | Kısa bir bekleyişten sonra tekrar deneyin. Süregelen 500 hatalarını bildirin. |
503 | Tüm sağlayıcılar meşgul veya model adı mevcut değil. | Mesajı okuyun: meşgul durumu dakikalar içinde geçer, yazım hatası geçmez. |
Çok farklı iki durum 503 durumunu paylaşır. İlki geçici bir tıkanıklıktır:
HTTP/1.1 503 Service Unavailable
{
"error": {
"message": "All providers for model \"kimi-k2.6:free\" are busy right now (they hit their rate limit). This is not a spelling error. Please try again in a little while, or switch to another model. (request id: 20260705...)",
"type": "new_api_error",
"code": "get_channel_failed"
}
}get_channel_failed, o model için her ücretsiz sağlayıcının hız sınırına takıldığı anlamına gelir. Dakikalar içinde geçer: tekrar deneyin veya model değiştirin. model_not_found, adın çözümlenmediği anlamına gelir; tekrar denemek işe yaramaz. Yazım hatalarını veya kataloğu kontrol edin.
get_channel_failed hatasını tekrar denenebilir, model_not_found hatasını kalıcı hata olarak kabul edin.
Yük altında kaybolan model kendiliğinden döner; döndüğü anda haber almak için şurada izleyin: Bildirimler
Anahtarınız sağlayıcı gruplarını sabitliyorsa, yalnızca sabitlediğiniz gruplar düştüğünde görülen üçüncü bir 503 vardır, bkz. Grup Sabitleme
429 durumunda Retry-After değerine uyun. 503 get_channel_failed hatasını kısa bir bekleyişten sonra tekrar deneyin ya da model değiştirin. 400 sınıfı hataları tekrar denemeyin.
Başarısız ve reddedilen istekler asla faturalanmaz; ön bloke ve iadenin işleyişi şurada: Hesap ve Faturalandırma