حدود المعدل والأخطاء

يمكن أن يأتي 429 من عدة طبقات:

• سقفنا للنماذج المجانية: طلب واحد في الدقيقة، لكلّ نموذج مجاني، لكلّ مستخدم.
• حدود المصدر: بلغ المزوّد خلف نموذج مجاني سقفه الخاصّ.
• ميزانيات رموز يومية على بعض المجمّعات المجانية، تُصفّر عند منتصف الليل بتوقيت UTC.
• سقوف الرموز في الدقيقة، تنطلق مع المطالبات الضخمة جدًّا.
• حدّ تزامن لكلّ مستخدم على الطلبات المتوازية.

لا توجد على النماذج المدفوعة حدود معدل يفرضها UnoRouter.

حين ينطلق سقف الطلب الواحد في الدقيقة، تحصل على ترويسات حدّ المعدّل القياسية:

HTTP/1.1 429 Too Many Requests
Retry-After: 38
X-RateLimit-Limit: 1
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1783198478

الترويسة Retry-After هي الثواني المتبقّية في نافذتك، لا 60 ثابتة. وتسمّي الرسالة النموذج المدفوع الذي لا حدّ له.

بعض النماذج المدفوعة تُقدَّم مجانًا مع سقف لحجم الطلب. والمطالبات المتجاوزة تعيد 413: Request body too large for gpt-4.1 model. Max size: 8000 tokens.

ينطبق السقف على المسار المجاني فقط. أمّا النموذج المدفوع فيقبل المطالبات بطولها الكامل.

تعيد الأخطاء JSON بصيغة أخطاء OpenAI. وحقل code معرّف ثابت. ويُلحق معرّف الطلب بكلّ رسالة:

{
  "error": {
    "message": "Model \"gpt-5.5-typo\" is not offered here. Check the model name for typos, or switch to a model from our supported list. (request id: 20260705...)",
    "type": "new_api_error",
    "code": "model_not_found"
  }
}

أدرج معرّف الطلب في تذاكر الدعم. فهو يحدّد موضع طلبك في السجلّات.

إذا كنت ما زلت تُعد مفتاحك أو عنوان URL الأساسي، فابدأ من البدء السريع

رموز الحالة التي ستصادفها فعلًا:

تتشارك حالتان مختلفتان تمامًا الرمز 503. الأولى ازدحام مؤقت:

HTTP/1.1 503 Service Unavailable

{
  "error": {
    "message": "All providers for model \"kimi-k2.6:free\" are busy right now (they hit their rate limit). This is not a spelling error. Please try again in a little while, or switch to another model. (request id: 20260705...)",
    "type": "new_api_error",
    "code": "get_channel_failed"
  }
}

يعني get_channel_failed أنّ كلّ مزوّد مجاني لذلك النموذج مقيّد بحدّ المعدّل. وينقشع خلال دقائق: أعد المحاولة أو بدّل النموذج. أمّا model_not_found فيعني أنّ الاسم لا يُحلّ؛ وإعادة المحاولة لا تنفع أبدًا. تحقّق من الأخطاء المطبعية أو من الكتالوج.

تعامل مع get_channel_failed كخطأ قابل لإعادة المحاولة ومع model_not_found كخطأ نهائي.

النموذج الذي اختفى تحت الضغط يعود من تلقاء نفسه؛ لتصلك إشارة لحظة عودته راقبه في الإشعارات

إذا كان مفتاحك يثبّت مجموعات مزودين، فهناك حالة 503 ثالثة عندما تتعطل مجموعاتك المثبتة فقط، راجع تثبيت المجموعات

احترم Retry-After عند الخطأ 429. أعد محاولة 503 get_channel_failed بعد انتظار قصير، أو بدّل النموذج. ولا تعد محاولة أخطاء فئة 400.

الطلبات الفاشلة والمرفوضة لا تُحاسَب أبدًا؛ آلية الحجز المسبق والاسترداد موضحة في الحساب والفوترة