Platform Kılavuzu

Hatalar ve Hız Sınırları

Her durum kodunun ne anlama geldiği ve bu konuda ne yapılması gerektiği.

Hata biçimi

Hatalar, OpenAI hata biçiminde JSON olarak geri döner. Mesaj ne olduğunu belirtir, code kararlı, makine tarafından okunabilir bir tanımlayıcıdır ve her mesaja bir istek kimliği eklenir:

json

{
  "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"
  }
}

Destekle iletişime geçtiğinizde veya bir Discord bileti açtığınızda istek kimliğini her zaman ekleyin. Bu, günlüklerde tam isteğinizi bulmamızı sağlar.

Bir bakışta durum kodları

Gerçekten karşılaşacağınız durum kodları:

Kod	Anlamı	Ne yapmalı
`400`	Geçersiz istek: hatalı parametre değerleri (örneğin model minimumunun altında max_tokens) veya içerik denetimi tarafından engellenen bir prompt.	İsteği düzeltin. Değiştirmeden yeniden denemek yine başarısız olur.
`401`	Anahtar sorunu: eksik, geçersiz, süresi dolmuş veya devre dışı bırakılmış API anahtarı.	Authorization başlığını ve anahtarınızı Token sayfasında kontrol edin.
`402`	Bu anahtarın kendi harcama limiti tükendi.	Anahtarın limitini yükseltin veya yeni bir anahtar oluşturun.
`403`	Erişim reddedildi: hesap bakiyesi boş, model bu anahtar için izinli değil veya IP'niz anahtarın izin listesinde değil.	Bakiye yükleyin veya anahtarın model ve IP kısıtlamalarını kontrol edin.
`413`	İstek, bu modelin ücretsiz deneme sınırı için çok büyük.	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 yeniden deneyin; sürekli 500'ler bildirilmeye değer.
`503`	Modelin tüm sağlayıcıları meşgul veya model adı mevcut değil.	Mesajı okuyun: meşguliyet dakikalar içinde çözülür, yazım hatası çözülmez.

503: meşgul ve bilinmeyen model

Çok farklı iki durum 503 durumunu paylaşır. İlki geçici bir tıkanıklıktır:

text

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 kodu (tüm sağlayıcılar meşgul), o model için her ücretsiz sağlayıcının anlık olarak hız sınırlı olduğu anlamına gelir. Bu, dakikalar içinde kendiliğinden düzelir: yeniden deneyin veya model değiştirin. model_not_found kodu (burada sunulmuyor), model adının kendisinin çözümlenmediği anlamına gelir ve yeniden denemek asla yardımcı olmaz. Yazım hatalarını kontrol edin veya güncel adı katalogda arayın.

get_channel_failed içeren 503'ü yeniden deneme/yedek olarak, model_not_found içeren 503'ü ise istemcinizde kalıcı bir hata olarak ele alın.

Hız sınırı türleri

Bir 429 birkaç katmandan gelebilir:

Ücretsiz model sınırımız: kullanıcı başına ücretsiz model başına dakikada 1 istek. Paylaşılan havuzların yoğun saatlerde ayakta kalması için bir adalet sınırı.
Upstream sağlayıcı sınırları: ücretsiz bir modelin arkasındaki sağlayıcı kendi sınırına ulaştı ("temporarily rate-limited upstream", yani upstream tarafında geçici olarak hız sınırlı).
Bazı ücretsiz havuzlarda günlük token bütçeleri; bunlar UTC gece yarısında sıfırlanır.
Çok büyük promptlarda tetiklenen dakika başına token sınırları.
Çok fazla istek paralel çalıştığında kullanıcı başına eşzamanlılık sınırı.

Ücretli modellerin UnoRouter tarafından uygulanan hız sınırı yoktur.

Ücretsiz model sınırı ayrıntılı olarak

Dakikada 1 sınırımız tetiklendiğinde, istemcilerin tam olarak geri çekilebilmesi için standart hız sınırı başlıkları alırsınız:

text

HTTP/1.1 429 Too Many Requests
Retry-After: 38
X-RateLimit-Limit: 1
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1783198478

Retry-After dinamiktir: pencerenizde kalan gerçek saniye sayısıdır, sabit 60 değil. Hata mesajı ayrıca modelin sınırı olmayan ücretli ikizini de adlandırır.

Deneme boyutu sınırları

Normalde ücretli olan bazı modeller, bir istek boyutu sınırıyla ücretsiz sunulur. Aşırı büyük promptlar şöyle bir mesajla 413 alır: Request body too large for gpt-4.1 model. Max size: 8000 tokens.

Sınır yalnızca ücretsiz deneme rotası için geçerlidir; ücretli model tam uzunlukta promptları kabul eder.

Yeniden deneme rehberi

429'da Retry-After'a uyun. 503 get_channel_failed'i kısa bir bekleyişten sonra yeniden deneyin veya başka bir modele geçin. 400 sınıfı hataları yeniden denemeyin, bunlar belirlenimcidir.

Başarısız ve reddedilen istekler faturalandırılmaz: istek hataya düştüğünde bakiyenizdeki her ön blokaj iade edilir.