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

تعود الأخطاء بصيغة JSON بتنسيق أخطاء OpenAI. تبيّن message ما حدث، و 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"
  }
}

أدرج دائمًا معرّف الطلب عند التواصل مع الدعم أو فتح تذكرة على Discord. فهو يتيح لنا العثور على طلبك الدقيق في السجلات.

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

تتشارك حالتان مختلفتان تمامًا الرمز 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 (غير مقدَّم هنا) يعني أن اسم النموذج نفسه لا يُحلّل، وإعادة المحاولة لن تفيد أبدًا. تحقق من الأخطاء الإملائية أو ابحث عن الاسم الحالي في الكتالوج.

تعامل مع 503 المصحوب بـ get_channel_failed على أنه إعادة محاولة أو تجاوز، ومع 503 المصحوب بـ model_not_found على أنه خطأ صارم في عميلك.

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

• حدّنا للنماذج المجانية: طلب واحد في الدقيقة لكل نموذج مجاني لكل مستخدم. حدّ عدل كي تصمد المجمّعات المشتركة في ساعات الذروة.
• حدود المزود في المنبع: بلغ المزود خلف نموذج مجاني حدّه الخاص ("temporarily rate-limited upstream"، أي محدود المعدل مؤقتًا في المنبع).
• ميزانيات رموز يومية على بعض المجمّعات المجانية؛ تُعاد تهيئتها عند منتصف الليل بتوقيت UTC.
• حدود الرموز في الدقيقة التي تنطلق مع المطالبات الكبيرة جدًا.
• حد تزامن لكل مستخدم عندما يعمل عدد كبير جدًا من الطلبات على التوازي.

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

عندما ينطلق حدّنا البالغ 1 في الدقيقة تحصل على ترويسات حد معدل قياسية، بحيث يمكن للعملاء التراجع بدقة:

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.

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

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

لا تُفوتر الطلبات الفاشلة والمرفوضة: يُعاد أي حجز مسبق على رصيدك عندما يخطئ الطلب.