OpenRouter free tier کی حدیں اور 429 errors کیسے ٹھیک کریں

فوری جواب: دقیق free tier حدیں

OpenRouter مفت استعمال کو دو محوروں پر محدود کرتا ہے: ایک per-minute ceiling اور ایک روزانہ request بجٹ۔ مفت model variants (وہ model IDs جو :free پر ختم ہوں) کے لیے per-minute حد 20 requests فی منٹ ہے۔ روزانہ بجٹ اس پر منحصر ہے کہ آیا آپ کے account نے کبھی کم از کم $10 کے credits خریدے ہیں: اس lifetime حد سے نیچے آپ کو روزانہ 50 مفت-model requests ملتی ہیں، اس پر یا اس سے اوپر آپ کو روزانہ 1,000 ملتی ہیں۔ یہ وہ اعداد ہیں جو OpenRouter 2026 کے آغاز تک دستاویز کرتا ہے۔ یہ پہلے بھی بدل چکے ہیں (روزانہ حد پہلے زیادہ ہوا کرتی تھی)، اس لیے table کو ایک مستقل ضمانت کی بجائے موجودہ baseline سمجھیں، اور اگلے حصے میں دیے گئے check سے اپنی key کے خلاف تصدیق کریں۔ ایک 429 response کا مطلب ہے کہ آپ ان میں سے کسی حد سے تجاوز کر گئے، یا وہ upstream provider جو اس مفت model کو سرو کر رہا تھا capacity ختم ہو گئی حالانکہ آپ کا ذاتی quota ٹھیک تھا۔ اس گائیڈ کا باقی حصہ یہ بتاتا ہے کہ کیسے پتا لگائیں آپ کس سے ٹکرائے اور اس کے بارے میں کیا کرنا ہے۔

free tier اصل میں کیسے کام کرتا ہے

OpenRouter پر مفت models :free suffix والے الگ catalog entries ہیں۔ یہ ایسے providers سے سرو ہوتے ہیں جو capacity donate یا subsidize کرتے ہیں، یہی وجہ ہے کہ ان کی دستیابی انہی weights کے paid variants سے کہیں زیادہ بدلتی رہتی ہے۔ تین تفصیلات لوگوں کو الجھا دیتی ہیں۔ پہلی، روزانہ حد پورے account پر ہے: 50 requests کسی بھی مفت models کے مرکب پر پھیلی ہوئی، فی model 50 نہیں۔ دوسری، $10 کی حد lifetime credit خریداریوں کو گنتی ہے، موجودہ balance کو نہیں۔ ایک بار $10 خریدنا آپ کو 1,000 requests فی دن والے bracket میں رکھتا ہے، خرچ کر لینے کے بعد بھی۔ تیسری، حدیں فی account نافذ ہوتی ہیں، اس لیے اسی account کے تحت اضافی API keys بنانے سے کچھ نہیں بڑھتا۔ آپ بالکل چیک کر سکتے ہیں کہ آپ کی 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 حد سے نیچے
# "usage": 1.42           -> استعمال شدہ credits
# "rate_limit": {...}     -> اس key پر فی-وقفہ حد

429s peak گھنٹوں میں کیوں بڑھتے ہیں

آپ کی ذاتی حدیں کہانی کا صرف آدھا حصہ ہیں۔ مفت capacity ایک shared pool ہے، اور OpenRouter کسی مفت request کو صرف اسی provider کی طرف route کر سکتا ہے جس کے پاس اس لمحے فالتو subsidized capacity ہو۔ جب کوئی مقبول مفت model سیر ہو جائے تو آپ کو 429 یا upstream errors ملتے ہیں چاہے آپ نے اس دن صرف چند requests ہی بھیجی ہوں۔ کمیونٹی رپورٹس مسلسل US time zones کی شاموں اور ہفتہ وار چھٹیوں کو بدترین windows بتاتی ہیں، جبکہ off-peak گھنٹوں پر وہی request فوراً کامیاب ہو جاتی ہے۔ یہ تخمینی مشاہدات ہیں، publish شدہ نمبر نہیں، مگر اتنی بار دہرائے جاتے ہیں کہ ان کے گرد planning کی جا سکے۔ Chat frontends اس مسئلے کو بڑھا دیتے ہیں۔ SillyTavern اور JanitorAI جیسے interfaces ہر swipe، regenerate، اور group chat turn کے لیے ایک نئی completion request بھیجتے ہیں، اور کچھ proxy setups ناکامیوں کو خودکار طور پر retry کرتے ہیں۔ جس user کو لگتا ہے کہ اس نے 15 messages بھیجے ہیں اس نے شاید 40 سے 50 requests پیدا کی ہوں، جو $10 کی حد سے نیچے والے account کا پورا روزانہ بجٹ ہے۔ جارحانہ خودکار retries بھی سب کے لیے peak congestion گہرا کر دیتے ہیں، یہی وجہ ہے کہ نظم و ضبط والا backoff اہم ہے۔ عملی diagnostic: اگر روزانہ reset تک انتظار کرنے پر 429s رک جائیں تو آپ اپنے quota سے ٹکرائے تھے۔ اگر وہ ایک ہی گھنٹے کے اندر آتے جاتے رہیں جبکہ آپ کی request count کم ہو، تو آپ pool congestion دیکھ رہے ہیں۔

Fixes، کوشش کی ترتیب میں

اگر آپ ٹریفک کو free tier پر رکھتے ہیں، تو minimum viable client ناکام ہونے یا اندھا دھند retry کرنے کی بجائے 429 کو واضح طور پر handle کرتا ہے:

• پہلے error body پڑھیں۔ OpenRouter کے 429s آپ کی per-minute حد، ختم ہونے والے روزانہ quota، اور upstream congestion میں فرق کرتے ہیں۔ جس سے آپ اصل میں ٹکرائے اسے ٹھیک کریں۔
• Retry-After کا احترام کریں اور jitter کے ساتھ exponentially back off کریں۔ endpoint کو مسلسل مارنا آپ کو زیادہ دیر rate limited رکھتا ہے اور congestion بڑھاتا ہے۔
• ایک بار $10 lifetime credit کی حد پار کریں۔ یہ روزانہ حد کو 50 سے 1,000 requests تک اٹھا دیتا ہے اور daily-quota 429s کے لیے سب سے زیادہ اثر رکھنے والا fix ہے۔
• اہم ٹریفک کو اسی model کے paid variant پر منتقل کریں۔ DeepSeek-class models کی قیمت فی ملین tokens ایک ڈالر سے کہیں کم ہے، اس لیے chat کی ایک بھاری شام عام طور پر چند سینٹ کی پڑتی ہے۔
• Client پر request حجم کم کریں: auto-regeneration بند کریں، غیر ضروری swipes سے بچیں، اور context کاٹیں تاکہ جب 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 فی دن کافی نہ ہوں تو متبادل

اگر آپ کا استعمال کا pattern مسلسل مفت بجٹ سے اوپر ہے، تو چار حقیقت پسندانہ راستے ہیں۔ صحیح راستہ اس پر منحصر ہے کہ آپ کی رکاوٹ روزانہ quota ہے، peak-hour congestion ہے، یا دونوں۔ نوٹ کریں کہ paid options بنیادی طور پر overhead میں مختلف ہیں، request shape میں نہیں: یہ سب ایک ہی OpenAI-compatible chat completions format بولتے ہیں، اس لیے switching صرف ایک base URL اور key کی تبدیلی ہے، rewrite نہیں۔

براہ راست gateway پر chat frontend چلانا

ایک direct gateway OpenAI-compatible request shape برقرار رکھتا ہے مگر free-pool queue ہٹا دیتا ہے، کیونکہ ہر request paid capacity ہے۔ APIsRouter ایک مثال ہے: جتنا استعمال اتنی ادائیگی، کوئی subscription نہیں، اور /topup پر بغیر سائن اپ کے checkout جہاں آپ پہلے ادائیگی کرتے ہیں اور API key ای میل پر پہنچتی ہے۔ Global models official list قیمت سے 20% کم پر چلتے ہیں، Chinese models اپنی official rates سے کم پر بیٹھتے ہیں، اور پہلی top-up آپ کا شروعاتی balance دوگنا کر دیتی ہے۔ Frontend setup وہی ہے جو آپ پہلے سے OpenRouter کے ساتھ کرتے ہیں۔ SillyTavern میں، وہ base URL پیسٹ کریں جو /v1 پر ختم ہو (https://api.apisrouter.com/v1) اور model list آپ کی key کے ساتھ /v1/models سے خود بھر جائے گی۔ JanitorAI کی proxy configuration کو اس کی بجائے مکمل endpoint چاہیے: https://api.apisrouter.com/v1/chat/completions، ساتھ model کا نام اور API key۔ character chat اور roleplay ٹریفک کے لیے، DeepSeek V4 family value کے لیے کمیونٹی کی پسندیدہ ہے، ساتھ MiMo، GLM-5، اور Kimi K2.6 مزید value picks کے طور پر۔ Claude Sonnet 4.6، Anthropic کی content policy کے تحت safe-for-work creative writing کے لیے سب سے مضبوط 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"}]
  }'

عمومی سوالات