الانتقال إلى المحتوى الرئيسي
يطبّق OrcaRouter حدود المعدل على مستوى مساحة العمل، وليس لكل مفتاح API. تستمد جميع المفاتيح التابعة لمساحة العمل نفسها من الحصة نفسها. عند تجاوز الحد تحصل على استجابة HTTP 429 Too Many Requests مع رأس Retry-After.

​
لماذا النطاق على مستوى مساحة العمل

مساحات العمل هي الطريقة التي يجمع بها OrcaRouter المفاتيح والأعضاء والفواتير التي تنتمي إلى فريق واحد أو فرد واحد. الحدود المشتركة داخل مساحة العمل تجعل حركة المرور قابلة للتنبؤ مع نمو فريقك: إضافة مفتاح جديد (أو عضو جديد) لا تضاعف ميزانيتك المشتركة. إذا احتجت إلى سقف أعلى، فقم بترقية خطة مساحة العمل. لا يكشف OrcaRouter حدود المعدل لكل نموذج للمستدعين — فالبوابة تتصرف كمزود منطقي واحد من وجهة نظر تطبيقك، بما يتسق مع عتامة المزود. يحدث التحكم الداخلي بالتدفق نحو المزودين الأعليين بشفافية وهو ليس جزءًا من العقد العام.

​
الاستجابة

يُرجع الطلب المقيد بالمعدل دائمًا: 
HTTP/1.1 429 Too Many Requests
Retry-After: <seconds>
تتضمن بعض مسارات حدود المعدل أيضًا نص JSON يشرح الحد الذي تم بلوغه؛ بينما تُرجع مسارات أخرى (حصة مساحة العمل الأسرع) رمز الحالة والرؤوس فقط. لا تعتمد على شكل النص — تحقق من رمز الحالة 429 واقرأ Retry-After. عند وجود النص فإنه يتبع الغلاف المتوافق مع OpenAI مع ضبط error.type على orcarouter_api_error. قد تكون error.message مترجمة (حاليًا بالصينية) — راجع الأخطاء للاطلاع على بنية الغلاف. Retry-After بالثواني. وهو مدة نافذة حد المعدل (محافظ — من الآمن الانتظار هذه المدة بالضبط)؛ النافذة التالية ستملك حصة كاملة. إعادة المحاولة فورًا دون انتظار ستفشل مرة أخرى.

​
السلوك الموصى به للعميل

  1. عند 429، اقرأ Retry-After.
  2. انتظر هذا العدد من الثواني.
  3. أعد إرسال الطلب نفسه.
  4. إذا حدث 429 ثانٍ، فضاعف زمن الانتظار 2× (تراجع أسي) حتى 60 ثانية.
  5. إذا رأيت 429 بشكل متكرر، ففكّر في تقسيم حركة المرور عبر نماذج متعددة باستخدام extra_body.models — راجع بدائل النموذج.
تتعامل حزم OpenAI لـ Python وTypeScript مع Retry-After تلقائيًا افتراضيًا. لا تحتاج إلى كود مخصص ما لم تكن قد عطّلت إعادة المحاولات.

​
تفاعلي، وليس تنبئيًا

لا يُرجع OrcaRouter رؤوس X-RateLimit-Remaining / X-RateLimit-Reset، لذلك لا يمكنك التحقق مسبقًا من مقدار الحصة المتبقية. عامل 429 كإشارة — تراجع عند رؤيته، ثم استأنف.