OpenRouter free tier limits और 429 errors कैसे fix करें

Quick answer: exact free tier limits

OpenRouter free usage को दो axes पर cap करता है: एक per-minute ceiling और एक daily request budget। Free model variants (जिनकी model IDs :free पर end होती हैं) के लिए per-minute limit 20 requests per minute है। Daily budget इस पर depend करता है कि आपके account ने कभी lifetime में कम-से-कम $10 credits purchase किए हैं या नहीं: उस lifetime threshold से नीचे आपको प्रति day 50 free-model requests मिलते हैं, उस पर या उससे ऊपर आपको प्रति day 1,000 मिलते हैं। ये वो figures हैं जो OpenRouter 2026 की शुरुआत तक document करता है। ये पहले भी बदले हैं (daily cap पहले ज़्यादा था), इसलिए table को एक permanent guarantee की बजाय current baseline मानें, और अगले section के check से अपनी key के against verify करें। एक 429 response का मतलब है आप इनमें से किसी एक cap को exceed कर गए, या उस free model को serve करने वाला upstream provider capacity से बाहर हो गया भले ही आपका personal quota ठीक था। इस guide का बाकी हिस्सा यह cover करता है कि आपने कौन सा hit किया यह कैसे बताएं और इसके लिए क्या करें।

Free tier असल में कैसे काम करता है

OpenRouter पर free models अलग catalog entries हैं जिनके साथ :free suffix है। ये उन providers से serve होते हैं जो capacity donate या subsidize करते हैं, यही वजह है कि इनकी availability उन्हीं weights के paid variants से कहीं ज़्यादा swing करती है। तीन details लोगों को उलझा देती हैं। पहली, daily cap account wide है: 50 requests किसी भी free models के mix में फैले हैं, प्रति model 50 नहीं। दूसरी, $10 threshold lifetime credit purchases count करता है, current balance नहीं। एक बार $10 खरीदने से आप 1,000 requests per day वाले bracket में रहते हैं, भले ही आप बाद में उसे spend कर दें। तीसरी, limits प्रति account enforce होते हैं, इसलिए एक ही account के तहत extra API keys बनाने से कुछ नहीं जुड़ता। आप check कर सकते हैं कि आपकी key कहां खड़ी है। Response में is_free_tier, आपका usage अब तक, और आपकी key पर लागू rate limit object शामिल है:

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

# पढ़ने-लायक response fields:
# "is_free_tier": true    -> $10 lifetime threshold से नीचे
# "usage": 1.42           -> consume हुए credits
# "rate_limit": {...}     -> इस key पर per-interval limit

Peak hours पर 429s क्यों spike करते हैं

आपके personal caps सिर्फ आधी कहानी हैं। Free capacity एक shared pool है, और OpenRouter एक free request को उसी moment spare subsidized capacity वाले किसी provider पर route कर सकता है। जब कोई popular free model saturate हो जाता है, तो आपको 429 या upstream errors मिलते हैं भले ही आपने उस दिन सिर्फ कुछ ही requests किए हों। Community reports लगातार US time zones की evenings और weekends को सबसे खराब windows बताती हैं, वहीं वही request off-peak घंटों में तुरंत succeed हो जाता है। ये approximate observations हैं, published numbers नहीं, लेकिन इतनी बार दोहराती हैं कि इनके हिसाब से plan बनाया जा सके। Chat frontends इस problem को बढ़ा देते हैं। SillyTavern और JanitorAI style interfaces हर swipe, regenerate, और group chat turn के लिए एक fresh completion request भेजते हैं, और कुछ proxy setups automatically failures retry करते हैं। जिस user को लगता है उसने 15 messages भेजे, उसने शायद 40 से 50 requests generate किए हों, जो $10 threshold से नीचे वाले account का पूरा daily budget है। Aggressive automatic retries सबके लिए peak congestion को और गहरा कर देती हैं, यही वजह है कि disciplined backoff matter करता है। Practical diagnostic यह है: अगर daily reset तक wait करने पर 429s रुक जाएं, तो आप अपने quota से टकराए। अगर वे कम request count के बावजूद उसी घंटे के अंदर आते-जाते रहें, तो आप pool congestion देख रहे हैं।

Fixes, effort के क्रम में

अगर आप traffic free tier पर ही रखते हैं, तो minimum viable client fail होने या blind-retry करने की बजाय 429 को explicitly handle करता है:

• पहले error body पढ़ें। OpenRouter के 429s आपकी per-minute limit, आपके खत्म हो चुके daily quota, और upstream congestion के बीच फर्क करते हैं। जो असल में hit हुआ है उसे fix करें।
• Retry-After respect करें और jitter के साथ exponentially back off करें। Endpoint को hammer करने से आप ज़्यादा देर rate limited रहते हैं और congestion बढ़ जाता है।
• $10 lifetime credit threshold एक बार पार करें। यह daily cap को 50 से 1,000 requests तक बढ़ा देता है और daily-quota 429s के लिए सबसे highest-leverage fix है।
• जो traffic matter करती है उसे उसी model के एक paid variant पर move करें। DeepSeek-class models की cost प्रति मिलियन tokens एक dollar से काफी कम है, इसलिए chat की एक heavy evening आमतौर पर cents की पड़ती है।
• Client पर request volume कम करें: auto-regeneration disable करें, unnecessary swipes avoid करें, और context trim करें ताकि जब retry हो भी तो वह सस्ता पड़े।

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")

जब 50 requests per day काफी न हों तो alternatives

अगर आपका usage pattern लगातार free budget से ऊपर है, तो चार realistic paths हैं। सही वाला इस पर depend करता है कि आपकी bottleneck daily quota है, peak-hour congestion है, या दोनों। ध्यान दें कि paid options मुख्यतः overhead में अलग हैं, request shape में नहीं: ये सभी same OpenAI-compatible chat completions format बोलते हैं, इसलिए switch करना एक rewrite की बजाय सिर्फ base URL और key का बदलाव है।

Direct gateway पर एक chat frontend चलाना

एक direct gateway OpenAI-compatible request shape रखता है लेकिन free-pool queue हटा देता है, क्योंकि हर request paid capacity है। APIsRouter एक example है: कोई subscription नहीं, pay as you go, और /topup पर एक बिना-signup checkout जहां आप पहले pay करते हैं और API key email पर आती है। Global models official list pricing से 20% कम पर चलते हैं, Chinese models अपनी official rates से नीचे बैठते हैं, और पहला top-up आपका starting balance double कर देता है। Frontend setup वही है जो आप पहले से OpenRouter के साथ करते हैं। SillyTavern में, /v1 पर end होने वाला base URL paste करें (https://api.apisrouter.com/v1) और model list आपकी key के साथ /v1/models से auto-populate हो जाती है। JanitorAI के proxy configuration को इसकी बजाय पूरा endpoint चाहिए: https://api.apisrouter.com/v1/chat/completions, साथ में model name और API key। Character chat और roleplay traffic के लिए, value के मामले में DeepSeek V4 family community favorite है, साथ में MiMo, GLM-5, और Kimi K2.6 आगे के value picks हैं। Claude Sonnet 4.6 Anthropic की content policy के तहत safe-for-work creative writing के लिए सबसे strong prose लिखता है।

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"}]
  }'

अक्सर पूछे जाने वाले प्रश्न