التراجع عند الفشل

تتيح آلية التراجع عند الفشل في 诺玛AI التبديل التلقائي إلى نموذج احتياطي عند تعذّر الوصول إلى النموذج الرئيسي، مما يضمن استمرارية خدمتك دون انقطاع.

آلية العمل#

• إرسال الطلب إلى النموذج الرئيسي
• إذا أعاد النموذج الرئيسي خطأ (5xx، انتهاء المهلة، تجاوز حد الطلبات، إلخ)
• تجربة النماذج في قائمة fallback بالترتيب تلقائياً
• إعادة أول استجابة ناجحة

التراجع لطلب واحد#

قم بتهيئة التراجع لطلب واحد عبر معامل `provider.fallback`:

from openai import OpenAI
 
client = OpenAI(
    base_url="https://as.apinoma.com/v1",
    api_key="<مفتاح APINOMA_API_KEY الخاص بك>"
)

response = client.chat.completions.create(
    model="openai/gpt-4o",  # النموذج الرئيسي
    messages=[{"role": "user", "content": "مرحبا"}],
    extra_body={
        "provider": {
            "fallback": [
                "anthropic/claude-sonnet-4.6",  # البديل الأول
                "google/gemini-pro-compatible-flash-lite-preview"              # البديل الثاني
            ]
        }
    }
)

# عرض النموذج المستخدم فعلياً
print(response.model)

شروط تفعيل التراجع#

تُفعَّل آلية التراجع في الحالات التالية:

الحالة

الوصف

HTTP 5xx

خطأ في الخادم

انتهاء مهلة الطلب

انتهاء مهلة استجابة النموذج

429 تجاوز حد الطلبات

وصول النموذج الأعلى مستوى إلى حد معدل الطلبات

النموذج غير متاح

صيانة المزود أو إيقافه

لا تُفعَّل آلية التراجع في الحالات التالية:

الحالة

الوصف

HTTP 4xx (بخلاف 429)

أخطاء العميل تستلزم تصحيح الطلب

تصفية المحتوى

رفض النموذج توليد المحتوى

الاستخدام مع التوجيه#

يمكن دمج آلية التراجع مع توجيه المزودين:

response = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "مرحبا"}],
    extra_body={
        "provider": {
            "routing": "latency",    # توجيه بالأولوية للزمن المنخفض
            "fallback": [             # قائمة التراجع
                "anthropic/claude-sonnet-4.6",
                "google/gemini-pro-compatible-flash-lite-preview"
            ]
        }
    }
)

خطط التراجع الموصى بها#

للنماذج الموصى بها، راجع سوق النماذج.

أفضل الممارسات#

• اختر نماذج احتياطية بقدرات مماثلة — للحفاظ على جودة المخرجات بعد التراجع
• التراجع عبر مزودين مختلفين — تفادياً لتوقّف نماذج المزود نفسه في آنٍ واحد
• ضبط 2-3 بدائل — يكفي لمعالجة معظم سيناريوهات الأعطال
• مراقبة تكرار التراجع — إن تكرّر كثيراً، قد يلزم تغيير النموذج الرئيسي

آخر تحديث: 23 يونيو 2026