OpenRouter ücretsiz katman limitleri ve 429 hatalarını çözme

Hızlı yanıt: kesin ücretsiz katman limitleri

OpenRouter, ücretsiz kullanımı iki eksende sınırlar: dakika başına bir tavan ve günlük bir istek bütçesi. Ücretsiz model varyantları (:free ile biten model ID'leri) için dakika başına limit, dakikada 20 istektir. Günlük bütçe, hesabınızın hiç en az $10 kredi satın alıp almadığına bağlıdır: bu yaşam boyu eşiğin altındaysanız günde 50 ücretsiz model isteği alırsınız, eşitse ya da üzerindeyse günde 1.000 alırsınız. Bunlar OpenRouter'ın 2026'nın başı itibarıyla belgelediği rakamlardır. Daha önce değişmişlerdir (günlük tavan eskiden daha yüksekti), bu yüzden tabloyu kalıcı bir garanti değil güncel taban çizgisi olarak ele alın ve bir sonraki bölümdeki kontrolle kendi anahtarınıza karşı doğrulayın. Bir 429 yanıtı, bu tavanlardan birini aştığınız ya da kişisel kotanız uygun olsa bile o ücretsiz modeli servis eden yukarı akış sağlayıcısının kapasitesinin tükendiği anlamına gelir. Bu rehberin geri kalanı, hangisine çarptığınızı nasıl anlayacağınızı ve ne yapmanız gerektiğini kapsıyor.

Ücretsiz katman gerçekte nasıl çalışır

OpenRouter'daki ücretsiz modeller, :free soneki taşıyan ayrı katalog girdileridir. Kapasiteyi bağışlayan ya da sübvanse eden sağlayıcılar tarafından servis edilirler, bu yüzden kullanılabilirlikleri aynı ağırlıkların ücretli varyantlarından çok daha fazla dalgalanır. İnsanları şaşırtan üç ayrıntı var. Birincisi, günlük tavan hesap geneli: 50 istek, model başına 50 değil, herhangi bir ücretsiz model karışımına yayılmış olarak. İkincisi, $10 eşiği mevcut bakiyeyi değil yaşam boyu kredi satın alımlarını sayar. Bir kez $10 satın almak, harcadıktan sonra bile sizi günde 1.000 istek diliminde tutar. Üçüncüsü, limitler hesap başına uygulanır, bu yüzden aynı hesap altında ekstra API anahtarları oluşturmak hiçbir şey eklemez. Anahtarınızın tam olarak nerede durduğunu kontrol edebilirsiniz. Yanıt is_free_tier, o ana kadarki kullanımınızı ve anahtarınıza şu anda uygulanan hız limiti nesnesini içerir:

curl https://openrouter.ai/api/v1/auth/key \
  -H "Authorization: Bearer $OPENROUTER_API_KEY"

# Okumaya değer yanıt alanları:
# "is_free_tier": true    -> $10 yaşam boyu eşiğinin altında
# "usage": 1.42           -> harcanan krediler
# "rate_limit": {...}     -> bu anahtardaki aralık başına limit

429 hataları neden yoğun saatlerde yükselir

Kişisel tavanlarınız hikayenin yalnızca yarısı. Ücretsiz kapasite paylaşılan bir havuzdur ve OpenRouter, ücretsiz bir isteği ancak o anda boş sübvanse edilmiş kapasitesi olan bir sağlayıcıya yönlendirebilir. Popüler bir ücretsiz model doyuma ulaştığında, o gün yalnızca birkaç istek yapmış olsanız bile 429 ya da yukarı akış hataları alırsınız. Topluluk raporları, ABD saat dilimlerindeki akşamları ve hafta sonlarını tutarlı biçimde en kötü pencereler olarak tanımlıyor, aynı isteğin yoğun olmayan saatlerde hemen başarılı olmasıyla birlikte. Bunlar yaklaşık gözlemlerdir, yayımlanmış rakamlar değil, ama plan yapmaya değecek kadar sık tekrarlanıyorlar. Sohbet ön yüzleri sorunu büyütür. SillyTavern ve JanitorAI tarzı arayüzler her kaydırma, yeniden üretme ve grup sohbeti turu için yeni bir tamamlama isteği gönderir ve bazı proxy kurulumları başarısızlıkları otomatik olarak yeniden dener. 15 mesaj gönderdiğini hisseden bir kullanıcı 40 ila 50 istek üretmiş olabilir, bu da $10 eşiğinin altındaki bir hesabın tüm günlük bütçesidir. Agresif otomatik yeniden denemeler ayrıca herkes için zirve tıkanıklığını derinleştirir, bu yüzden disiplinli geri çekilme önemlidir. Pratik teşhis şudur: günlük sıfırlamayı bekleyince 429'lar duruyorsa kotanıza çarpmışsınızdır. İstek sayınız düşükken aynı saat içinde gelip gidiyorlarsa havuz tıkanıklığı görüyorsunuzdur.

Çözümler, çaba sırasına göre

Trafiği ücretsiz katmanda tutmaya devam ederseniz, minimum uygulanabilir istemci 429'u başarısız olmak ya da körlemesine yeniden denemek yerine açıkça işler:

• Önce hata gövdesini okuyun. OpenRouter 429'ları dakika başına limitiniz, tükenmiş günlük kotanız ve yukarı akış tıkanıklığı arasında ayrım yapar. Gerçekten çarptığınızı düzeltin.
• Retry-After'a uyun ve jitter ile üstel olarak geri çekilin. Endpoint'e vurmaya devam etmek sizi daha uzun süre hız sınırlı tutar ve tıkanıklığı kötüleştirir.
• $10 yaşam boyu kredi eşiğini bir kez geçin. Bu, günlük tavanı 50'den 1.000 isteğe yükseltir ve günlük kota 429'ları için en yüksek kaldıraçlı tek düzeltmedir.
• Önemli olan trafiği aynı modelin ücretli bir varyantına taşıyın. DeepSeek sınıfı modeller milyon token başına bir doların hayli altına mal olur, bu yüzden yoğun bir akşam sohbet kullanımı genellikle birkaç sente mal olur.
• İstemcide istek hacmini azaltın: otomatik yeniden üretmeyi kapatın, gereksiz kaydırmalardan kaçının ve her yeniden deneme gerçekleştiğinde daha ucuz olması için bağlamı kırpın.

import random
import time

import requests

def chat(payload: dict, key: str, retries: int = 5) -> dict:
    for attempt in range(retries):
        r = requests.post(
            "https://openrouter.ai/api/v1/chat/completions",
            headers={"Authorization": f"Bearer {key}"},
            json=payload,
            timeout=120,
        )
        if r.status_code != 429:
            r.raise_for_status()
            return r.json()
        wait = float(r.headers.get("Retry-After", 2 ** attempt + random.random()))
        time.sleep(wait)
    raise RuntimeError("Still rate limited after all retries")

Günde 50 istek yetmediğinde alternatifler

Kullanım örüntünüz sürekli olarak ücretsiz bütçenin üzerindeyse, dört gerçekçi yol var. Doğru olanı, darboğazınızın günlük kota mı, zirve saati tıkanıklığı mı yoksa ikisi birden mi olduğuna bağlı. Ücretli seçeneklerin esas olarak genel giderde farklılaştığını, istek şeklinde değil, not edin: hepsi aynı OpenAI uyumlu sohbet tamamlama formatını konuşur, bu yüzden geçiş bir yeniden yazım değil bir base URL ve anahtar değişikliğidir.

Doğrudan bir gateway üzerinde sohbet ön yüzü çalıştırmak

Doğrudan bir gateway, OpenAI uyumlu istek şeklini korurken ücretsiz havuz kuyruğunu kaldırır, çünkü her istek ücretli kapasitedir. APIsRouter bir örnek: abonelik olmadan kullandıkça öde ve önce ödeyip API anahtarının e-posta ile geldiği kayıt gerektirmeyen bir ödeme akışı /topup'ta. Küresel modeller resmi listenin %20 altında çalışır, Çin modelleri resmi oranlarının altında oturur ve ilk yükleme başlangıç bakiyenizi ikiye katlar. Ön yüz kurulumu OpenRouter'da zaten yaptığınızı yansıtır. SillyTavern'de, /v1 ile biten base URL'yi yapıştırın (https://api.apisrouter.com/v1) ve model listesi anahtarınız girildiğinde /v1/models üzerinden otomatik doldurulur. JanitorAI'ın proxy yapılandırması bunun yerine tam endpoint'i ister: https://api.apisrouter.com/v1/chat/completions, artı model adı ve API anahtarı. Karakter sohbeti ve rol yapma trafiği için, DeepSeek V4 ailesi değer açısından topluluk favorisidir, MiMo, GLM-5 ve Kimi K2.6 ek değer seçenekleri olarak. Claude Sonnet 4.6, Anthropic'in içerik politikası altında iş için uygun yaratıcı yazımda en güçlü düzyazıyı yazar.

curl https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Sık sorulan sorular