حدود الطبقة المجانية لـOpenRouter وكيفية إصلاح أخطاء 429

إجابة سريعة: الحدود الدقيقة للطبقة المجانية

يحدّ OpenRouter الاستخدام المجاني على محورين: سقف في الدقيقة وميزانية طلبات يومية. الحد في الدقيقة لأشكال النماذج المجانية (معرّفات النماذج المنتهية بـ:free) هو 20 طلباً في الدقيقة. الميزانية اليومية تعتمد على ما إذا كان حسابك قد اشترى على الإطلاق $10 على الأقل من الرصيد: دون تلك العتبة مدى الحياة تحصل على 50 طلب نموذج مجاني في اليوم، عندها أو فوقها تحصل على 1,000 في اليوم. هذه هي الأرقام التي يوثقها OpenRouter اعتباراً من أوائل 2026. تغيّرت من قبل (الحد اليومي كان أعلى سابقاً)، لذا تعامل مع الجدول كخط أساس حالي وليس ضماناً دائماً، وتحقق مقابل مفتاحك الخاص بالفحص في القسم التالي. رد 429 يعني أنك تجاوزت أحد هذه الحدود، أو أن المزود upstream الذي يخدم ذلك النموذج المجاني نفدت سعته حتى لو كانت حصتك الشخصية بخير. بقية هذا الدليل يغطي كيفية معرفة أيهما وصلت وماذا تفعل حيال ذلك.

كيف تعمل الطبقة المجانية فعلياً

النماذج المجانية على OpenRouter هي إدخالات كتالوج منفصلة بلاحقة :free. تُخدَم من قبل مزودين يتبرعون بالسعة أو يدعمونها، ولهذا السبب توفرها يتذبذب أكثر بكثير من الأشكال المدفوعة لنفس الأوزان. ثلاثة تفاصيل تُوقع الناس. أولاً، الحد اليومي على مستوى الحساب: 50 طلباً موزعة عبر أي مزيج من النماذج المجانية، وليس 50 لكل نموذج. ثانياً، عتبة $10 تحسب مشتريات الرصيد مدى الحياة، وليس الرصيد الحالي. شراء $10 مرة واحدة يُبقيك في شريحة 1,000 طلب في اليوم حتى بعد إنفاقها. ثالثاً، الحدود تُطبَّق لكل حساب، لذا إنشاء مفاتيح API إضافية تحت نفس الحساب لا يضيف شيئاً. يمكنك التحقق بالضبط من موضع مفتاحك. الرد يتضمن is_free_tier، استخدامك حتى الآن، وكائن حد المعدل المُطبَّق حالياً على مفتاحك:

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

# حقول الرد الجديرة بالقراءة:
# "is_free_tier": true    -> دون عتبة $10 مدى الحياة
# "usage": 1.42           -> الرصيد المُستهلك
# "rate_limit": {...}     -> الحد لكل فترة على هذا المفتاح

لماذا ترتفع أخطاء 429 في ساعات الذروة

حدودك الشخصية نصف القصة فقط. السعة المجانية مجمع مشترك، وOpenRouter يمكنه فقط توجيه طلب مجاني إلى مزود لديه سعة مدعومة فائضة في تلك اللحظة. عندما يتشبّع نموذج مجاني شائع، تحصل على 429 أو أخطاء upstream حتى لو أرسلت حفنة فقط من الطلبات ذلك اليوم. تقارير المجتمع تصف باستمرار المساءات بالمناطق الزمنية الأمريكية وعطلات نهاية الأسبوع كأسوأ النوافذ، مع نجاح نفس الطلب فوراً في ساعات خارج الذروة. هذه ملاحظات تقريبية، وليست أرقاماً منشورة، لكنها تتكرر بما يكفي للتخطيط حولها. واجهات المحادثة الأمامية تضخّم المشكلة. واجهات على طراز SillyTavern وJanitorAI ترسل طلب إكمال جديداً لكل swipe وإعادة توليد ودورة محادثة جماعية، وبعض إعدادات الـproxy تُعيد محاولة الإخفاقات تلقائياً. مستخدم يشعر أنه أرسل 15 رسالة قد يكون قد ولّد 40 إلى 50 طلباً، وهي كامل الميزانية اليومية لحساب دون عتبة $10. إعادة المحاولة التلقائية العدوانية تُعمّق أيضاً الازدحام في الذروة للجميع، ولهذا السبب backoff المنضبط مهم. التشخيص العملي: إذا توقفت أخطاء 429 عندما تنتظر حتى إعادة التعيين اليومية، فقد وصلت حصتك. إذا كانت تأتي وتذهب خلال نفس الساعة بينما عدد طلباتك منخفض، فأنت ترى ازدحام المجمع.

الإصلاحات، بترتيب الجهد

إذا أبقيت الحركة على الطبقة المجانية، العميل الأدنى القابل للتطبيق يتعامل مع 429 بشكل صريح بدلاً من الفشل أو إعادة المحاولة العمياء:

• اقرأ جسم الخطأ أولاً. أخطاء 429 في OpenRouter تُميّز بين حد الدقيقة الخاص بك، وحصتك اليومية المُستنفدة، وازدحام upstream. أصلح الذي وصلته فعلياً.
• احترم Retry-After وتراجع أُسّياً مع jitter. قصف endpoint بشكل متكرر يُبقيك محدود المعدل لفترة أطول ويُسوّئ الازدحام.
• تجاوز عتبة $10 من الرصيد مدى الحياة مرة واحدة. يرفع الحد اليومي من 50 إلى 1,000 طلب وهو الإصلاح الأعلى تأثيراً لأخطاء 429 الخاصة بالحصة اليومية.
• انقل الحركة المهمة إلى شكل مدفوع من نفس النموذج. نماذج فئة DeepSeek تكلف أقل بكثير من دولار لكل مليون token، لذا مساء ثقيل من المحادثة عادة يكلف سنتات.
• قلّل حجم الطلبات عند العميل: عطّل إعادة التوليد التلقائي، تجنّب الـswipes غير الضرورية، وقلّم السياق حتى تكون كل إعادة محاولة أرخص عندما تحدث.

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 طلباً في اليوم

إذا كان نمط استخدامك باستمرار فوق الميزانية المجانية، هناك أربعة مسارات واقعية. الصحيح منها يعتمد على ما إذا كان عنق الزجاجة لديك هو الحصة اليومية، ازدحام ساعة الذروة، أو كليهما. لاحظ أن الخيارات المدفوعة تختلف بشكل رئيسي في العبء الإضافي، وليس في شكل الطلب: كلها تتحدث نفس تنسيق إكمالات المحادثة المتوافق مع OpenAI، لذا التبديل هو تغيير base URL ومفتاح وليس إعادة كتابة.

تشغيل واجهة محادثة أمامية على بوابة مباشرة

بوابة مباشرة تُبقي شكل الطلب المتوافق مع OpenAI لكنها تزيل طابور المجمع المجاني، لأن كل طلب سعة مدفوعة. APIsRouter مثال واحد: ادفع حسب الاستخدام بدون اشتراك، ودفع بدون تسجيل في /topup حيث تدفع أولاً ومفتاح API يصل بالبريد الإلكتروني. النماذج العالمية بخصم 20% عن تسعير القائمة الرسمية، النماذج الصينية تقع دون أسعارها الرسمية، وأول عملية إيداع تُضاعف رصيدك الابتدائي. إعداد الواجهة الأمامية يعكس ما تفعله بالفعل مع OpenRouter. في SillyTavern، الصق base URL المنتهي بـ/v1 (https://api.apisrouter.com/v1) وقائمة النماذج تُملأ تلقائياً من /v1/models بمفتاحك. إعدادات proxy الخاصة بـJanitorAI تحتاج endpoint الكامل بدلاً من ذلك: https://api.apisrouter.com/v1/chat/completions، بالإضافة إلى اسم النموذج ومفتاح API. لحركة محادثة الشخصيات ولعب الأدوار، عائلة DeepSeek V4 هي المفضلة لدى المجتمع من حيث القيمة، مع MiMo وGLM-5 وKimi K2.6 كخيارات قيمة إضافية. Claude Sonnet 4.6 يكتب أقوى نثر للكتابة الإبداعية الآمنة للعمل تحت سياسة محتوى Anthropic.

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

الأسئلة الشائعة