حدود معدل الاستخدام في OpenRouter: تعتمد فئتك المجانية على ما قمت بدفعه سابقاً

Built for Speed: ~10ms Latency, Even Under Load
Blazingly fast way to build, track and deploy your models!
- Handles 350+ RPS on just 1 vCPU — no tuning needed
- Production-ready with full enterprise support
فشل الطلب رقم 51.
تتحقق من صفحة النموذج وتجد أنها ما زالت تشير إلى أنه مجاني. تتحقق من رصيدك وتجد أن فيه أموالاً. تتحقق من الوثائق وتجد حداً يبلغ 20 طلباً في الدقيقة، وهو حد لم تكن قريباً منه حتى، لأنك كنت ترسل حوالي ثلاثة طلبات فقط.
ما واجهته كان الحد اليومي. وتعتمد زيادة هذا الحد على أمر لا تفكر أي بوابة أخرى في ربطه به: إجمالي الأموال التي قدمتها لـ OpenRouter على مدار استخدامك. عند شراء أقل من 10 رصيدات على مدار عمر حسابك، تمنحك النماذج المجانية 50 طلباً في اليوم. وعند الوصول إلى 10 رصيدات أو أكثر، تحصل على 1,000 طلب. هذه الترقية دائمة، لذا يمكنك إنفاق الرصيد بالكامل، والعودة إلى رصيد صفر، مع الاحتفاظ بالحد الأقصى الأعلى.
هذه هي المعلومة الأكثر فائدة التي يجب معرفتها حول حدود معدل الاستخدام في OpenRouter، وليست المفاجأة الوحيدة. لقد قضينا أسبوعين في اختبار المنصة مكثفاً لتقييم البوابة. إليك ما وجدناه، بما في ذلك بعض الأمور التي لا تذكرها الوثائق الرسمية.
ما هي حدود معدل الاستخدام في OpenRouter؟
يمكن لأربع آليات منفصلة رفض طلبك، ومن السهل الخلط بينها.
الأولى هي حد النماذج المجانية: 20 طلباً في الدقيقة، و50 أو 1,000 طلب في اليوم، وتُطبق على أي معرف نموذج ينتهي بـ :free. هذا الحد معلن ومتوقع. الثانية هي سعة المزود الذي يقوم بالفعل بتقديم الخدمة لطلبك المدفوع، وهو ما لا تنشره OpenRouter ولا يمكنها التحكم فيه حقاً. الثالثة هي حماية Cloudflare من هجمات DDoS، والموصوفة في وثائقهم فقط بكونها تحجب الطلبات التي تتجاوز الاستخدام المعقول بشكل كبير، دون إرفاق أي رقم. الرابعة هي أي ميزانية أو حد رصيد قمت بإعداده بنفسك، وهو ليس حد معدل استخدام على الإطلاق ولكنه يرفض حركة المرور بنفس الطريقة.
الآلية الأولى فقط هي حد معدل الاستخدام بالمعنى الذي تقصده عندما تقول "حد معدل الاستخدام". أما البقية فهي سعة خاصة بطرف آخر، أو شبكة أمان صارمة، أو شؤونك المحاسبية الخاصة.

الفئة المجانية تعتمد على سجل مدفوعاتك
حد الـ 20 طلباً في الدقيقة ثابت. لا يتغير بتغير حالة حسابك أو رصيدك أو حجم إنفاقك. إذا كنت بحاجة إلى أكثر من 20 طلباً في الدقيقة، فالنماذج المجانية ليست هي الحل ولن يغير أي مبلغ من المال ذلك.
الحد اليومي هو المربوط بسجل المدفوعات، والعتبة تعتمد على المشتريات التراكمية مدى الحياة بدلاً من الرصيد الحالي. الحد الأدنى لشراء الرصيد في OpenRouter هو $5، لذا فإن الوصول إلى $10 يعد خطوة ثانية متعمدة وليس سعر الدخول. إن الشراء على جزأين بقيمة $5 لكل منهما يوصلك إلى نفس النتيجة مثل عملية شراء واحدة بقيمة $10، على حد علمنا.

ما يجعل هذا الأمر غريباً هو اتجاه السببية. إن الحد الأقصى لمعدل الإنتاجية لديك ليس دالة في خطتك أو نمط حركة المرور لديك. بل هو دالة في قرار الشراء، مما يعني أن قراراً مالياً يجيب الآن على سؤال يتعلق بالتوافر. في مشروع جانبي، هذا أمر مقبول. ولكن بمجرد أن يصبح لديك مستخدمون، فأنت على بعد تأخير محاسبي واحد من تغيير السعة.
هناك فخ ثانٍ تحته: الطلبات الفاشلة قد تُحسب ضمن الحد اليومي المسموح به. حلقات إعادة المحاولة التي تضغط على نموذج مجاني مشغول قد تستهلك الـ 50 طلباً الخاصة بك دون إعادة إكمال واحد صالح للاستخدام. إذا كنت تنوي إعادة المحاولة، فحدد حداً أقصى للمحاولات.
حدودك الحقيقية توجد في استدعاء API واحد
لن تعيدك لوحة التحكم إلى عداد الحدود. ولكن استدعاء GET /api/v1/key سيفعل ذلك، ويعيد بالضبط ما تطبقه OpenRouter على هذا المفتاح في الوقت الحالي.
هناك أمران يجب ملاحظتهما. أولاً، is_free_tier هو آلية سجل المدفوعات مرة أخرى، ولكنه الآن كقيمة منطقية (boolean) يجب على منطق الإنتاجية لديك قراءتها. ثانياً، وهذا هو الجزء الذي يقع فيه الكثيرون، لا يزال الرد يحتوي على كائن rate_limit والذي تشير وثائق OpenRouter الخاصة حالياً إلى أنه مهجور وتطلب منك تجاهله.
الكثير من الأدلة الإرشادية ومهارات البرمجة بالذكاء الاصطناعي الخارجية لم تواكب هذا التحديث. ستجد جداول حدود معدل الاستخدام تذكر 20 طلباً كل 10 ثوانٍ للحسابات غير الممولة و200 طلب كل 10 ثوانٍ للحسابات الممولة، وكلها مشتقة من ذلك الحقل غير المستعمل. هذه الأرقام لا تعبر عن أي شيء تطبقه المنصة اليوم. إذا كانت هناك لوحة تحكم أو قاعدة تنبيه أو مكتبة عميل خاصة بك تقرأ قيمة rate_limit، فهي تقرأ قيمة لا يقوم أحد بصيانتها.
في النماذج المدفوعة، الحد الأقصى ليس مملوكاً لـ OpenRouter
لا تنشر OpenRouter أي حد لطلبات المنصة بالنسبة للنماذج المدفوعة، وقد بحثنا عن واحد. إن إجراء اختبار للتزامن على حركة المرور المفلترة بالرصيد عند 1 و4 و8 و16 طلباً قيد التشغيل لم ينتج عنه أي رفض على أي مستوى. لا توجد أخطاء 429، ولا إسقاط للطلبات، ولا تنظيم في طوابير. والوسيط الزمني لأول رمز ممتاز (token) لم يتحرك تقريباً بين طلب واحد وستة عشر طلباً قيد التشغيل.
لم نجد الحد الأقصى. توقف الاختبار عند 16 وشمل نماذج مقدمة من OpenAI، لذا اعتبر ذلك حداً أدنى وليس رقماً نهائياً: لم تقم البوابة بتقييدنا تحت 16 طلباً متزامناً، والنقطة التي يبدأ عندها التقييد لا تزال سؤالاً مفتوحاً.
مما يعني أن خطأ 429 في نموذج مدفوع لا يعني عادةً أن OpenRouter تطلب منك التبطئة. بل هو المزود الذي يقدم سلسلة النموذج تلك حالياً. وبما أن التوجيه يمكن أن ينقلك بين المضيفين دون تغيير سلسلة النموذج، فإن السعة التي تعمل معها يمكن أن تتغير بين طلب وآخر. يمكنك جعلها متوقعة عن طريق التثبيت باستخدام provider.order أو provider.only، على حساب ميزة التحويل التلقائي عند الفشل (failover) التي افترضنا أنك اعتمدت البوابة الموجهة للحصول عليها.
أربعة رموز أخطاء، وأربع مشكلات مختلفة
لا شيء في وثائق OpenRouter يجمع هذه الرموز في مكان واحد، والرمز هو أسرع طريقة لمعرفة الطبقة التي رفضتك للتو.
يقع الكثيرون في خطأ 402، لأنه يعني أن كلمة "مجاني" مشروطة بعدم سحب الحساب على المكشوف. إذا أصبح رصيدك بالسالب، ستتوقف النماذج المجانية عن العمل أيضاً.
احتفظ بـ 403 بعيداً عن مسار إعادة المحاولة تماماً. إعادة المحاولة لا تحقق أي شيء، لأن ما يحظرك هو سياسة وليس طابور انتظار. لقد وصلنا إلى حد مفتاح مستنفد أثناء الاختبار وتلقينا رد 403 واضحاً ينص على "Key limit exceeded (total limit)" مع رابط مباشر إلى صفحة إعدادات ذلك المفتاح. ويجب إعطاء الأقدار حقها: أخطاء OpenRouter للقرارات الخاصة بها ممتازة. أما الأخطاء المنقولة من المزودين فهي بحسب ما يراه المزود مناسباً، وكلاهما يصلان تحت نفس الرسالة الرئيسية، لذا فإن رمز الحالة هو إشارتك الموثوقة الوحيدة لمعرفة البيئة التي تتواجد فيها.
إعادة المحاولة وفترات المهلة هي مسؤوليتك
هذا هو الجزء الذي كلفنا معظم الوقت. إن إعادات المحاولة والتراجع والـ jitter ليست قابلة للتكوين. لقد أرسلنا max_retries وكائن سياسة إعادة محاولة مهيكل، وعاد كلاهما بـ HTTP 200 بدون خطأ، مما يعني أنه تم قبولهما وتجاهلهما بدلاً من احترامهما. ونفس القصة مع timeout.
السبب هو وجود فجوة في التحقق من الصحة. تتحقق OpenRouter من المفاتيح داخل كائن provider مقابل قائمة معروفة وترفض المفاتيح غير المعروفة بشكل صحيح. أما المفاتيح ذات المستوى الأعلى فلا يتم التحقق منها. لذا فإن التعليمات غير المدعومة ذات المستوى الأعلى تمنحك استجابة ناجحة دون أي إشارة إلى أنها لم تفعل شيئاً، وهو فشل أسوأ مما لو كان خطأ 400.
لا توجد مهلة خمول للبث أيضاً، لا على الخادم ولا كمعلمة عميل. عبر ما يقرب من 4,300 طلب، كان لدينا بثان انتهيا مبكراً بدون أي خطأ HTTP على الإطلاق. نادرة الحدوث، ولكن يجب على العميل لديك ملاحظة ذلك، لأنه لا يوجد شيء آخر سيخبرك.
كل ذلك يضع التحكم في الوتيرة وإعادات المحاولة وفترات المهلة داخل تطبيقك. يذكر مدونة الهندسة في OpenRouter ذلك، ونحن نفضل أن يقولوا ذلك بدلاً من التظاهر بخلافه. هذا يعني أنه إذا كنت تدير عدة خدمات، فستكتب هذا المنطق عدة مرات.
الميزانيات ليست حدوداً لمعدل الاستخدام
تدمج الفرق بين هذه الأفكار في فكرة واحدة ثم تتساءل لماذا لم يعمل أي منهما كما هو متوقع. حدود معدل الاستخدام تحمي السعة خلال نافذة زمنية. الميزانيات تحمي الأموال عبر فترة زمنية. في OpenRouter، هما ميزتان منفصلتان تعيدان رموز حالة مختلفة.
تتم إعادة ضبط حدود رصيد المفاتيح يومياً أو أسبوعياً أو شهرياً عند منتصف الليل بتوقيت UTC، مع بدء الأسابيع من الاثنين إلى الأحد. اتراك إعادة الضبط دون إعداد وسيكون لديك حد أقصى مدى الحياة. نقطة الإسناد غير قابلة للتكوين، لذا إذا كان شهرك المالي يبدأ في اليوم 25، أو يعمل فريقك بتوقيت IST، فلن تتوافق إعادات الضبط لديك مع تقاريرك.
تتداخل ميزانيات حواجز الحماية عبر نوافذ مدى الحياة والشهري والأسبوعي واليومي، ويجب أن تنخفض الحدود بصرامة كلما ضاقت النافذة. كما أنها لا تتشارك، وهو ما يفاجئ البعض: إذا أعطيت ثلاثة مهندسين نفس حاجز حماية الميزانية اليومية، فسيحصل كل واحد منهم على تلك الميزانية بشكل منفصل، بينما يُحسب الطلب الواحد ضمن ميزانية المفتاح وميزانية مالك المفتاح معا. يبقى إنفاق BYOK غير مرئي للميزانيات ما لم يتم تشغيل include_byok_in_budgets، وهو خيار افتراضي محتمل للفواتير ولكنه ضعيف للحوكمة.
التطبيق هو إيقاف صارم وليس مجرد تحذير. لا يوجد وضع تحذير فقط موثق، لذا فإن أول علامة على وجود ميزانية هي فشل حركة المرور. جانب الرسوم في كل هذا يقع خارج نطاق هذا المنشور، ولكن مقالنا حول تفاصيل تسعير OpenRouter يغطي رسوم شراء الرصيد بنسبة 5.5% وحصة BYOK بالتفصيل.
أين تتوقف الوكلاء الذكية (Agents) بالفعل
يحسب الحد المجاني اليومي الطلبات وليس الرموز الممتازة (tokens). محادثة من 100,000 رمز ممتاز وموجه من كلمتين يكلفانك نفس الشيء تماماً: طلباً واحداً. يبدو ذلك سخياً حتى تقوم بتشغيل دالة حلقة أدوات (tool loop)، حيث قد يقوم مهمة واحدة بإجراء عشرين استدعاءً ويتم الوصول إلى الحد الأقصى للطلبات قبل أي شيء متعلق بالرموز الممتازة.
يساعد التخزين المؤقت للاستجابة (Response Caching) بشكل محدود. بتمكينه لكل طلب باستخدام الترويسة X-OpenRouter-Cache: true، يعود الطلب المماثل تماماً في حوالي 58 ميلي ثانية بدلاً من 2,900 ميلي ثانية، وبسعر صفر، ولا تستهلك الاستجابة حد معدل الاستخدام للمزود لأن الطلب لا يصل مطلقاً إلى المزود. لقد قمنا بفياس نسبة نجاح 100% عبر 300 طلب مكرر مماثل. القيود هي النقطة الأكثر أهمية: يتم تعيين القيود بناءً على مفتاح API الخاص بك بالإضافة إلى نص الطلب بالكامل، لذا فإن أسطولاً من الخدمات يستحوذ كل منها على مفتاحه الخاص لا يتشارك أي شيء، وتقع فترة الصلاحية (TTL) المقاسة بين دقيقتين وخمس دقائق. لا تزال موجودة عند 120 ثانية، وتختفي عند 300 ثانية. لا تنشر OpenRouter هذا الرقم. وهو يغطي عواصف إعادة المحاولة والتقديم المزدوج داخل الجلسة، وليس الاستعلامات التي تتكرر كل ساعة.

حد أقصى آخر يسبب المشاكل أثناء التقييم بدلاً من الإنتاج: الحساب المؤسسي يقتصر على 10 أعضاء، ويمكن رفعه عن طريق الاتصال بالدعم. إن تجربة المنصة عبر فريق منصة مكون من خمسين شخصاً تبدأ بتقديم تذكرة دعم.
كيف نفعل ذلك في TrueFoundry
تتخذ بوابة AI Gateway الخاصة بنا موقفاً مختلفاً بشأن أمرين: الوحدة التي تقوم بعدّها، وما إذا كانت السعة والمال هما نفس أداة التحكم.
نحن نحدد معدل الاستخدام بناءً على ست وحدات، requests_per_minute، requests_per_hour، requests_per_day، ونفس الوحدات الثلاث للرموز الممتازة (tokens). تعد الطلبات في الدقيقة مؤشراً ضعيفاً على الحمل عندما يكون استدعاء واحد قد يكون 200 رمز ممتاز أو 200,000 رمز ممتاز، لذا فإن العداد الذي يسمح بـ 1,000 طلب لا يمكنه إخبارهم بما إذا كنت على وشك إنفاق دولار أم أربعة أرقام. وحدات الرموز الممتازة يمكنها ذلك. تتم تغطية القواعد باستخدام rate_limit_applies_per، لذا يُطبق الحد لكل مستخدم، أو لكل فريق، أو لكل نموذج بدلاً من أن يكون ثابتاً على مفتاح، ونحن نسمح بحد أقصى قيمتين لكل قاعدة للحفاظ على السلوك متوقعاً.
شكل النافذة الزمنية يهم الوكلاء الذكية أكثر من البشر، لذا نستخدم نافذة منزلقة بعرض 60 ثانية مقسمة إلى فترات من 10 ثوانٍ، مع جمع الخانات الست الأخيرة. الاندفاع الكثيف للطلبات الذي يقع بين نهاية دقيقة محددة وبداية الدقيقة التالية لا يمكنه المرور بضعف الحد. يقدم دليلنا لتحديد معدل الاستخدام القائم على الرموز الممتازة والميزانيات شرحاً لخطوات التكوين.
تظل الميزانيات منفصلة، وتكلفة فقط، بالدولار الأمريكي، وتُطبق قبل تشغيل الاستدلال بدلاً من اكتشافها في الفاتورة. تضيف البوابة حوالي 3 إلى 4 ميلي ثانية من العبء الإضافي وتتعامل مع 350+ RPS على وحدة معالجة مركزية افتراضية واحدة (vCPU)، لذا فإن تقييم هذه القواعد لا يكلفك أي شيء تلاحظه.
والانتقال بين البوابات ليس الخطوة الوحيدة المتاحة، وهو ما نفضل قوله بصوت عالٍ. تدعم TrueFoundry منصة OpenRouter كمزود، بحيث يمكنك الاحتفاظ بكتالوجها وميزة التحويل التلقائي عند الفشل أثناء وضع حدود واعية بالرموز الممتازة، وميزانيات لكل فريق، وتسجيل منسوب للمستخدمين أمامه. بالنسبة للكثير من الفرق، هذه هي الخطوة الأولى الصحيحة. إذا كنت قطعْتَ شوطاً أطول وكانت القيود المذكورة أعلاه هي سبب قراءتك لهذا المقال، فإن مقالنا حول بدائل OpenRouter يقارن الخيارات المتاحة للاستخدام في بيئة الإنتاج.
قراءات ذات صلة
- تحديد معدل الاستخدام في AI Gateway: دليل كامل، المدخل المعماري الأساسي خلف هذا المنشور
- تحديد معدل استخدام API لنماذج LLMs: قم بعدّ الرموز الممتازة وليس الطلبات، حول عناصر التحكم الأربعة التي تتعامل معها الفرق عادةً كعنصر واحد
- تسعير OpenRouter في 2026، جانب الرصيد والرسوم من نفس الحساب
- تحسين تكلفة LLM: لماذا تعد بوابة الذكاء الاصطناعي هي الطبقة المفقودة، حول الميزانيات التي تعمل قبل وصول الفاتورة
- مقارنة Requesty ضد OpenRouter، مقارنة تفصيلية للفرق التي تبحث عن موجه
الخاتمة
حدود معدل الاستخدام في OpenRouter سهلة التحديد ولكن من الصعب البناء عليها. الأرقام المنشورة تغطي النماذج المجانية فقط. الحد الأقصى المدفوع يتبع مزوداً لم تقم باختياره. إعادات المحاولة وفترات المهلة تقع في كود تطبيقك سواء خططت لذلك أم لا. ومعدل الإنتاجية المجاني لديك هو دالة في سجل مدفوعاتك، وهي جملة غريبة اضطررنا لكتابتها.
هذا خيار مقبول للحصول على بضع مئات من النماذج خلف مفتاح واحد، ومعظم الفرق تقوم بذلك بسعادة. فقط من المفيد معرفة أين تقع الحدود قبل أن تكتشفها حلقة وكيل ذكي (agent loop) نيابة عنك.
إذا كنت تريد حدوداً تُحسب بالرموز الممتازة، وميزانيات منفصلة عن السعة، وتطبيق كلاهما داخل بنيتك التحتية الخاصة، شاهد كيف تتعامل TrueFoundry AI Gateway مع تحديد معدل الاستخدام.
TrueFoundry AI Gateway delivers ~3–4 ms latency, handles 350+ RPS on 1 vCPU, scales horizontally with ease, and is production-ready, while LiteLLM suffers from high latency, struggles beyond moderate RPS, lacks built-in scaling, and is best for light or prototype workloads.












.png)
.png)
.png)











.png)

.png)








