Blank white background with no objects or features visible.

تحية إلى منطقة أوروبا والشرق الأوسط وأفريقيا! توسع TrueFoundry نطاق حضورها في هذه المنطقة الحيوية. اقرأ المزيد ←

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

By Kshitij Gupta

Updated: نوفمبر 3, 2026

Published: أكتوبر 5, 2026

الملخص التنفيذي:

تقتصر النماذج المجانية على 20 طلباً في الدقيقة، وإما 50 أو 1,000 طلب في اليوم اعتماداً على إجمالي ما دفعته سابقاً لـ OpenRouter. لا تمتلك النماذج المدفوعة حداً معلناً، لذا فإن خطأ 429 هناك يعني في الغالب أن مزود الخدمة هو من يقوم بمعالجة طلبك وليس البوابة نفسها. تعبر أربعة رموز حالة مختلفة عن أربع مشكلات مختلفة، وواحدة منها فقط هي التي تستحق إعادة المحاولة.

فشل الطلب رقم 51.

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

ما واجهته كان الحد اليومي. وتعتمد زيادة هذا الحد على أمر لا تفكر أي بوابة أخرى في ربطه به: إجمالي الأموال التي قدمتها لـ OpenRouter على مدار استخدامك. عند شراء أقل من 10 رصيدات على مدار عمر حسابك، تمنحك النماذج المجانية 50 طلباً في اليوم. وعند الوصول إلى 10 رصيدات أو أكثر، تحصل على 1,000 طلب. هذه الترقية دائمة، لذا يمكنك إنفاق الرصيد بالكامل، والعودة إلى رصيد صفر، مع الاحتفاظ بالحد الأقصى الأعلى.

هذه هي المعلومة الأكثر فائدة التي يجب معرفتها حول حدود معدل الاستخدام في OpenRouter، وليست المفاجأة الوحيدة. لقد قضينا أسبوعين في اختبار المنصة مكثفاً لتقييم البوابة. إليك ما وجدناه، بما في ذلك بعض الأمور التي لا تذكرها الوثائق الرسمية.

ما هي حدود معدل الاستخدام في OpenRouter؟

يمكن لأربع آليات منفصلة رفض طلبك، ومن السهل الخلط بينها.

الأولى هي حد النماذج المجانية: 20 طلباً في الدقيقة، و50 أو 1,000 طلب في اليوم، وتُطبق على أي معرف نموذج ينتهي بـ :free. هذا الحد معلن ومتوقع. الثانية هي سعة المزود الذي يقوم بالفعل بتقديم الخدمة لطلبك المدفوع، وهو ما لا تنشره OpenRouter ولا يمكنها التحكم فيه حقاً. الثالثة هي حماية Cloudflare من هجمات DDoS، والموصوفة في وثائقهم فقط بكونها تحجب الطلبات التي تتجاوز الاستخدام المعقول بشكل كبير، دون إرفاق أي رقم. الرابعة هي أي ميزانية أو حد رصيد قمت بإعداده بنفسك، وهو ليس حد معدل استخدام على الإطلاق ولكنه يرفض حركة المرور بنفس الطريقة.

الآلية الأولى فقط هي حد معدل الاستخدام بالمعنى الذي تقصده عندما تقول "حد معدل الاستخدام". أما البقية فهي سعة خاصة بطرف آخر، أو شبكة أمان صارمة، أو شؤونك المحاسبية الخاصة.

الشكل 1: البوابات الخمس التي يمر بها الطلب، والرمز الذي يعيده كل منها.

الفئة المجانية تعتمد على سجل مدفوعاتك 

حد الـ 20 طلباً في الدقيقة ثابت. لا يتغير بتغير حالة حسابك أو رصيدك أو حجم إنفاقك. إذا كنت بحاجة إلى أكثر من 20 طلباً في الدقيقة، فالنماذج المجانية ليست هي الحل ولن يغير أي مبلغ من المال ذلك. 

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

الشكل 2: الحد الأقصى اليومي للنماذج المجانية كدالة لمشتريات الرصيد مدى الحياة.

ما يجعل هذا الأمر غريباً هو اتجاه السببية. إن الحد الأقصى لمعدل الإنتاجية لديك ليس دالة في خطتك أو نمط حركة المرور لديك. بل هو دالة في قرار الشراء، مما يعني أن قراراً مالياً يجيب الآن على سؤال يتعلق بالتوافر. في مشروع جانبي، هذا أمر مقبول. ولكن بمجرد أن يصبح لديك مستخدمون، فأنت على بعد تأخير محاسبي واحد من تغيير السعة. 

هناك فخ ثانٍ تحته: الطلبات الفاشلة قد تُحسب ضمن الحد اليومي المسموح به. حلقات إعادة المحاولة التي تضغط على نموذج مجاني مشغول قد تستهلك الـ 50 طلباً الخاصة بك دون إعادة إكمال واحد صالح للاستخدام. إذا كنت تنوي إعادة المحاولة، فحدد حداً أقصى للمحاولات. 

حدودك الحقيقية توجد في استدعاء API واحد 

لن تعيدك لوحة التحكم إلى عداد الحدود. ولكن استدعاء GET /api/v1/key سيفعل ذلك، ويعيد بالضبط ما تطبقه OpenRouter على هذا المفتاح في الوقت الحالي. 

الحقلما يخبرك به
limitحد الرصيد للمفتاح، أو null إذا لم تقم بإعداده مطلقاً
usageالرصيد المستهلك، طوال الوقت
usage_dailyالرصيد المستهلك في يوم UTC الحالي
usage_weeklyالرصيد المستهلك في أسبوع UTC هذا، والذي يبدأ يوم الاثنين
usage_monthlyالرصيد المستهلك في شهر UTC هذا
byok_usage بالإضافة إلى المتغيرات اليومية والأسبوعية والشهريةنفس العدادات لحركة المرور المقدمة عبر مفاتيح المزود الخاصة بك
is_free_tierما إذا كان الحساب قد قام بشراء رصيد من قبل أم لا
include_byok_in_limitما إذا كان إنفاق BYOK يُحسب ضمن حد الرصيد

هناك أمران يجب ملاحظتهما. أولاً، is_free_tier هو آلية سجل المدفوعات مرة أخرى، ولكنه الآن كقيمة منطقية (boolean) يجب على منطق الإنتاجية لديك قراءتها. ثانياً، وهذا هو الجزء الذي يقع فيه الكثيرون، لا يزال الرد يحتوي على كائن rate_limit والذي تشير وثائق OpenRouter الخاصة حالياً إلى أنه مهجور وتطلب منك تجاهله.

الكثير من الأدلة الإرشادية ومهارات البرمجة بالذكاء الاصطناعي الخارجية لم تواكب هذا التحديث. ستجد جداول حدود معدل الاستخدام تذكر 20 طلباً كل 10 ثوانٍ للحسابات غير الممولة و200 طلب كل 10 ثوانٍ للحسابات الممولة، وكلها مشتقة من ذلك الحقل غير المستعمل. هذه الأرقام لا تعبر عن أي شيء تطبقه المنصة اليوم. إذا كانت هناك لوحة تحكم أو قاعدة تنبيه أو مكتبة عميل خاصة بك تقرأ قيمة rate_limit، فهي تقرأ قيمة لا يقوم أحد بصيانتها.

تولَّ التحكم في حركة مرور نماذج LLM الخاصة بك
قم بتوجيه النماذج، وفرض الميزانيات، ومراقبة كل طلب من بنيتك التحتية الخاصة.

في النماذج المدفوعة، الحد الأقصى ليس مملوكاً لـ OpenRouter

لا تنشر OpenRouter أي حد لطلبات المنصة بالنسبة للنماذج المدفوعة، وقد بحثنا عن واحد. إن إجراء اختبار للتزامن على حركة المرور المفلترة بالرصيد عند 1 و4 و8 و16 طلباً قيد التشغيل لم ينتج عنه أي رفض على أي مستوى. لا توجد أخطاء 429، ولا إسقاط للطلبات، ولا تنظيم في طوابير. والوسيط الزمني لأول رمز ممتاز (token) لم يتحرك تقريباً بين طلب واحد وستة عشر طلباً قيد التشغيل.

لم نجد الحد الأقصى. توقف الاختبار عند 16 وشمل نماذج مقدمة من OpenAI، لذا اعتبر ذلك حداً أدنى وليس رقماً نهائياً: لم تقم البوابة بتقييدنا تحت 16 طلباً متزامناً، والنقطة التي يبدأ عندها التقييد لا تزال سؤالاً مفتوحاً.

مما يعني أن خطأ 429 في نموذج مدفوع لا يعني عادةً أن OpenRouter تطلب منك التبطئة. بل هو المزود الذي يقدم سلسلة النموذج تلك حالياً. وبما أن التوجيه يمكن أن ينقلك بين المضيفين دون تغيير سلسلة النموذج، فإن السعة التي تعمل معها يمكن أن تتغير بين طلب وآخر. يمكنك جعلها متوقعة عن طريق التثبيت باستخدام provider.order أو provider.only، على حساب ميزة التحويل التلقائي عند الفشل (failover) التي افترضنا أنك اعتمدت البوابة الموجهة للحصول عليها.

أربعة رموز أخطاء، وأربع مشكلات مختلفة

لا شيء في وثائق OpenRouter يجمع هذه الرموز في مكان واحد، والرمز هو أسرع طريقة لمعرفة الطبقة التي رفضتك للتو.

الرمزما الذي تسبب بالخطأأي طبقةما الذي يجب فعله حيال ذلك
429تكرار الطلباتحد النماذج المجانية، أو المزود الرئيسي في أحيان كثيرة جداًالتراجع من جانب العميل مع إضافة عشوائية (jitter)؛ قم بتثبيت مزود إذا كنت بحاجة إلى سعة متوقعة
402رصيد بالسالبنظام الفواتير في OpenRouter، وهو يوقف النماذج المجانية أيضاًأضف رصيداً لجعل الحساب أعلى من الصفر
403استنفاد حد الرصيد للمفتاح، أو وجود حاجز حماية حظرهطبقة السياسات في OpenRouterارفع حد المفتاح، أو قم بتعديل الميزانية أو قاعدة القائمة المسموحة
408مهلة طلب خاصة بـ 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 هذا الرقم. وهو يغطي عواصف إعادة المحاولة والتقديم المزدوج داخل الجلسة، وليس الاستعلامات التي تتكرر كل ساعة.

الشكل 3: مسبار واحد في كل من الفترات الخمس. تقع فترة TTL في الفجوة التي لم نغلقها.

حد أقصى آخر يسبب المشاكل أثناء التقييم بدلاً من الإنتاج: الحساب المؤسسي يقتصر على 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 يقارن الخيارات المتاحة للاستخدام في بيئة الإنتاج.

جرب TrueFoundry AI Gateway
قم بربط نماذجك وابدأ في إدارة حركة مرور نماذج LLM عبر API واحد.

قراءات ذات صلة

الخاتمة

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

هذا خيار مقبول للحصول على بضع مئات من النماذج خلف مفتاح واحد، ومعظم الفرق تقوم بذلك بسعادة. فقط من المفيد معرفة أين تقع الحدود قبل أن تكتشفها حلقة وكيل ذكي (agent loop) نيابة عنك.

إذا كنت تريد حدوداً تُحسب بالرموز الممتازة، وميزانيات منفصلة عن السعة، وتطبيق كلاهما داخل بنيتك التحتية الخاصة، شاهد كيف تتعامل TrueFoundry AI Gateway مع تحديد معدل الاستخدام.

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

Start free
Table of Contents

One Gateway for Every LLM, Agent and MCP Server

Book a 30-min with our AI expert

Book a Demo

The fastest way to build, govern and scale your AI

Book Demo
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Discover More

No items found.
نوفمبر 21, 2026
|
5 min read

هوية وكيل AI باستخدام Microsoft Entra Agent ID: إصدار هويات الوكلاء وإدارتها

No items found.
نوفمبر 21, 2026
|
5 min read

هوية الوكيل والتفويض بالنيابة (OBO): من الذي يستدعي أدواتك فعلياً؟

No items found.
نوفمبر 21, 2026
|
5 min read

agentgateway مقابل Vercel AI Gateway: بوابة وكلاء مستضافة ذاتيًا أم موجه نماذج مُدار؟

No items found.
نوفمبر 21, 2026
|
5 min read

مهارات العميل لـ Linear MCP: معيار الدقة من %62 ← %90

No items found.
No items found.

Recent Blogs

Black left pointing arrow symbol on white background, directional indicator.
Black left pointing arrow symbol on white background, directional indicator.
Take a quick product tour
Start Product Tour
Product Tour