Ana sayfa → Yardım

Bir 429'u doğru okumak – Retry-After ve sınır başlıkları

Bir 429 normalde saniye cinsinden bir Retry-After başlığı taşır ve çoğu zaman hangi sınırın tükendiğini ve ne zaman sıfırlanacağını belirten bir dizi başlık da içerir. O kadar beklemek sorunu çözer; hemen yeniden denemek uzatır.

Gördüğünüz hata

429 Too Many Requests with no obvious pattern
Retries make the problem worse
Only some requests fail while others succeed at the same moment
Rate limiting under a load that used to be fine

Neden oluyor

Sağlayıcılar aynı anda birkaç boyutu ölçer – dakikadaki istek sayısı, dakikadaki token sayısı ve bazen eşzamanlı istekler. İstek sınırının çok altındayken token sınırına takılmak, "yalnızca bazı isteklerin" başarısız olmasının sebebidir.

Token sınırları, gönderdiğiniz ile ayırdığınızı birlikte sayar. Büyük max_tokens değerli birkaç istek, istek sayısı önemsiz görünürken dakikalık token bütçesini tüketebilir.

Anında yeniden denemeler de sayılır. Sıkı bir yeniden deneme döngüsü bir saniyelik duraklamayı sürekli bir kilitlenmeye çevirir; geçici bir 429'un kalıcı hale gelmesinin olağan sebebi budur.

Sebebin bu olduğunu doğrulayın

429 aldığınızda gövde yerine başlıkları yazdırın:

curl -s -D- -o /dev/null -X POST 'YOUR_BASE_URL/chat/completions' \
  -H 'Authorization: Bearer YOUR_KEY' -H 'Content-Type: application/json' \
  -d '{"model":"MODEL","messages":[{"role":"user","content":"hi"}]}' \
  | grep -i 'retry-after\|ratelimit\|^HTTP'

Varsa Retry-After değerine uyun. Yoksa bir saniye civarından başlayan, jitter'lı üstel geri çekilme güvenli varsayılandır.

Nasıl düzeltilir

Kendi geri çekilmenizden önce Retry-After'a uyunBaşlık 12 saniye diyorsa 12 saniye beklemek işe yarar. Bir saniyelik geri çekilmeniz işe yaramaz ve size bir sonraki denemeyi de kaybettirir.
Jitter ekleyinRastgele bir kayma olmadan filonuzdaki her istemci adım adım aynı anda yeniden dener ve geri çekildiğiniz zirveyi yeniden oluşturur.
Gerçekten bir bakiye sorunu olup olmadığını kontrol edinBazı ağ geçitleri boş bir hesap için 429 döndürür. O, yeniden denemekle asla düzelmez – hız sınırı varsaymadan önce hata gövdesini okuyun.

APICLAN'da bakiye bittiği için gelen 429 ile üst sağlayıcı yoğunluğundan gelen 429 gövdede farklı şeyler söyler. İlki bakiye yüklemeyi gerektirir ve yeniden denemede asla başarılı olmaz; ikincisi genellikle saniyeler içinde düzelir.

İlgili konular

OpenAI uyumlu bir API'yi çağırırken Unexpected token '<' hatası 401 invalid API key – anahtar doğru göründüğü halde hata veriyorsa

Son kontrol: 2026-10-01. Canlı bir OpenAI uyumlu ağ geçidinde teşhis edilen sorunlardan yazılmıştır, başka sitelerden derlenmemiştir.