---
title: "التحويل التلقائي في LLM API إلى مزوّد احتياطي بـ Python"
description: "كيف تنفّذ التحويل التلقائي بين مزوّدي LLM المتوافقين مع OpenAI: أي الأخطاء تستدعيه، وقاطع الدائرة، وربط معرّفات النماذج، والبث المتدفق، وتكافؤ التكلفة والخصوصية."
url: https://broadrouter.com/ar/blog/llm-api-failover-fallback/
lang: ar
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/blog/llm-api-failover-fallback/) (حُدّث في 2026-11-16).

# التحويل التلقائي في LLM API: الانتقال إلى مزوّد احتياطي في شيفرتك

بقلم فريق BroadNet Inference · قراءة في 8 دقائق · تاريخ النشر 2026-11-15 · آخر تحديث 2026-11-16

احتفظ بقائمة مرتّبة من المزوّدين المتوافقين مع OpenAI، لكل منهم عميله ومعرّف نموذجه. انتقل إلى المزوّد التالي عند أخطاء الاتصال وانتهاء المهلة وأخطاء 5xx وأخطاء 429 الناتجة عن حد المعدل، بعد أن تستنفد إعادة المحاولة المدمجة في SDK. ولا تنتقل أبدًا عند 400 أو 401 أو 402 أو 403 أو 413 أو 422. أضف قاطع دائرة، وتأكد أن المزوّد الاحتياطي يطابق الأساسي في الميزات وشروط البيانات.

## أبرز النقاط

-   انتقل إلى المزوّد الاحتياطي عند أخطاء الاتصال وانتهاء المهلة و5xx وأخطاء 429 الناتجة عن حد المعدل، بعد عدد محدود من المحاولات. أما 400 أو 401 أو 402 أو 403 أو 413 أو 422 فستفشل بالطريقة نفسها لدى المزوّد التالي.
-   تختلف معرّفات النماذج بين المزوّدين: GLM 5.3 هو \`broadnet/glm-5.3\` في BroadNet، و\`zai-org/GLM-5.3\` في DeepInfra، و\`accounts/fireworks/models/glm-5p3\` في Fireworks.
-   قاطع الدائرة يمنعك من دفع ثمن انتهاء المهلة في كل طلب بينما المزوّد الأساسي متعطّل.
-   انقل البث المتدفق إلى مزوّد آخر قبل الرمز الأول فقط، ولا تُعِد أبدًا تشغيل استدعاء أداة يغيّر شيئًا.
-   لا تتولى BroadNet ولا BroadRouter التوجيه أو التحويل التلقائي نيابة عنك. ولا تتضمن خدمة BroadNet الذاتية أي التزام بالإتاحة، لذا ينبغي أن تحتفظ تطبيقات الإنتاج ببديل احتياطي.

**في هذه الصفحة**

1.  لماذا تحتفظ بمزوّد احتياطي أصلًا؟
2.  ما الأخطاء التي يجب أن تُطلق الانتقال التلقائي؟
3.  كيف يبدو الانتقال التلقائي في Python؟
4.  كيف تربط معرّفات النماذج بين المزوّدين؟
5.  كيف تبقي الإجابات متقاربة بعد التبديل؟
6.  ماذا عن البث المتدفق واستدعاءات الأدوات؟
7.  كم يكلّف الانتقال التلقائي؟
8.  هل يستوفي الاحتياطي شروط البيانات نفسها؟
9.  هل تستخدم بوابة مثل LiteLLM بدلًا من ذلك؟
10.  كيف تختبر الانتقال التلقائي قبل أن تحتاج إليه؟
11.  أين تقع BroadNet Inference من هذا؟

لكل LLM API دقائق سيئة: خطأ 503، أو انتهاء مهلة، أو دفعة من أخطاء 429. والبديل الاحتياطي يعني ألّا تتحول تلك الدقائق إلى انقطاع في تطبيقك. يشرح هذا المقال كيف تنتقل تلقائيًا بين مزوّدين [متوافقين مع OpenAI](https://broadrouter.com/ar/glossary/openai-compatible-api/) في شيفرتك أنت. ويغطي الأخطاء التي يجب أن تُطلق الانتقال، وكيف يبقيه قاطع الدائرة سريعًا، وما الذي يجب أن يتطابق بين المزوّدين كي لا يلاحظ المستخدمون التبديل.

أمر واحد قبل البدء: **لا توجّه BroadNet Inference الطلبات ولا تنتقل بين المزوّدين نيابة عنك**، ولا BroadRouter كذلك. فـ BroadRouter هو موقع BroadNet نفسها، وليس موجِّهًا. أنت من يبني البديل الاحتياطي، إما في العميل كما يلي، وإما في بوابة مثل LiteLLM.

## لماذا تحتفظ بمزوّد احتياطي أصلًا؟

لأن معظم واجهات الخدمة الذاتية لا تَعِد بشيء عن مدة التشغيل. وتقولها [شروط](https://www.broadnet.ai/terms) BroadNet صراحة في البند 7.4: “self-serve has no availability commitment” (الترجمة: «الخدمة الذاتية بلا التزام بالإتاحة»)، ولا توجد مستويات خدمة إلا في اتفاقية مكتوبة منفصلة (تاريخ المراجعة 15 نوفمبر 2026). ويغطي مقال [مقارنة SLA لواجهات LLM API](https://broadrouter.com/ar/blog/llm-api-sla-uptime-compared/) ما يلتزم به المزوّدون الآخرون. فإذا كان يجب أن تبقى ميزتك متاحة، فالمزوّد الثاني هو التأمين العملي، أيًّا كان ما تقوله اتفاقية مستوى الخدمة.

و[حدود المعدل](https://broadrouter.com/ar/glossary/rate-limit/) هي السبب الثاني. يسمح مفتاح الدفع حسب الاستخدام في BroadNet بـ 30 طلبًا في الدقيقة و4 طلبات متزامنة قيد التنفيذ. وأي ذروة في الحركة فوق ذلك تعيد أخطاء 429، ويستطيع مزوّد ثانٍ استيعاب الفائض بينما ترفع سعتك.

## ما الأخطاء التي يجب أن تُطلق الانتقال التلقائي؟

قسّم الأخطاء إلى مجموعتين. بعضها خطأ المزوّد وقد ينجح لدى غيره. وبعضها خطؤك أنت وسيفشل في كل مكان.

| الخطأ | تنتقل؟ | السبب |
| --- | --- | --- |
| خطأ اتصال، انتهاء المهلة | نعم، بعد إعادة المحاولة | المزوّد أو الشبكة لا يمكن الوصول إليهما |
| 500، 502، 503، 504 | نعم، بعد إعادة المحاولة | تقول وثائق BroadNet أن تبدأ بـ “retry with bounded exponential backoff” (الترجمة: «أعد المحاولة مع تراجع أسّي محدود») |
| 429، حد المعدل أو التزامن | نعم، بعد التراجع | السعة لدى هذا المزوّد، لا طلب خاطئ |
| 429، حد الإنفاق | لا | الانتقال يتجاوز الميزانية التي وضعتها عن قصد |
| 400، 422 | لا | الطلب غير صالح وسيفشل لدى المزوّد التالي أيضًا |
| 401، 402 | لا | المفتاح أو المخصّص أو الرصيد. في BroadNet يشمل 401 أيضًا نفاد مخصّص الدفع حسب الاستخدام، فالانتقال يخفي مشكلة في الفوترة |
| 403، 413 | لا | السياسة أو الحجم؛ أصلح الطلب |

يقول [المرجع التقني](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-blog-llm-api-failover-fallback&utm_content=body) لواجهة BroadNet إن 429 يعني “a rate, concurrency, token-rate or spending limit was reached” (الترجمة: «تم بلوغ حد للمعدل أو التزامن أو معدل الرموز أو الإنفاق»)، وأن عليك “use response details and bounded backoff” (الترجمة: «استخدام تفاصيل الاستجابة والتراجع المحدود»). اقرأ تلك التفاصيل قبل أن تنتقل، حتى يوقف خطأ 429 الناتج عن حد الإنفاق الطلبَ بدل أن ينقله. ويسرد [دليل رموز الأخطاء](https://broadrouter.com/ar/guides/errors-and-retries/) كل الحالات.

أعد المحاولة قبل أن تنتقل. تعيد مكتبة OpenAI Python SDK بالفعل محاولة أخطاء الاتصال واستجابات 408 و409 و429 و5xx “2 times by default, with a short exponential backoff” (الترجمة: «مرتين افتراضيًا، مع تراجع أسّي قصير»)، ومهلتها الافتراضية 10 دقائق ([README](https://github.com/openai/openai-python)، تاريخ المراجعة 15 نوفمبر 2026). وعشر دقائق مدة أطول بكثير من أن تنتظرها قبل الانتقال. اضبط `timeout` لكل عميل. ويغطي [مقال التعامل مع 429](https://broadrouter.com/ar/blog/handle-llm-api-429-rate-limits/) التراجع مع التذبذب العشوائي (jitter).

## كيف يبدو الانتقال التلقائي في Python؟

عميلان، وقائمة مرتّبة، وقاطع دائرة صغير. المزوّد الأساسي هو GLM 5.3 في BroadNet. والاحتياطي هو النموذج مفتوح الأوزان نفسه في DeepInfra، التي تذكر وثائقها عنوان URL الأساسي `https://api.deepinfra.com/v1/openai` (تاريخ المراجعة 15 نوفمبر 2026).

```python
import os
import time
from openai import (OpenAI, APIConnectionError, APITimeoutError,
                    RateLimitError, InternalServerError)

PROVIDERS = [
    {"name": "broadnet", "model": "broadnet/glm-5.3",
     "client": OpenAI(base_url="https://inference.broadnet.ai/v1",
                      api_key=os.environ["BROADNET_API_KEY"],
                      max_retries=2, timeout=60)},
    {"name": "deepinfra", "model": "zai-org/GLM-5.3",
     "client": OpenAI(base_url="https://api.deepinfra.com/v1/openai",
                      api_key=os.environ["DEEPINFRA_API_KEY"],
                      max_retries=2, timeout=60)},
]

# Provider-side failures only. 400, 401, 402, 403 and 422 raise straight through.
FAILOVER_ON = (APIConnectionError, APITimeoutError, RateLimitError, InternalServerError)
TRIP_AFTER = 3     # consecutive failures before the breaker opens
COOLDOWN = 30      # seconds to skip a provider once its breaker is open
state = {p["name"]: {"fails": 0, "open_until": 0.0} for p in PROVIDERS}

def chat(messages, **kwargs):
    last_error = None
    for p in PROVIDERS:
        s = state[p["name"]]
        if time.monotonic() < s["open_until"]:
            continue  # breaker open: don't wait on a provider that is down
        try:
            reply = p["client"].chat.completions.create(
                model=p["model"], messages=messages, **kwargs)
            s["fails"] = 0
            return p["name"], reply
        except FAILOVER_ON as err:
            last_error = err
            s["fails"] += 1
            if s["fails"] >= TRIP_AFTER:
                s["open_until"] = time.monotonic() + COOLDOWN
    raise RuntimeError("every provider failed") from last_error

served_by, reply = chat([{"role": "user", "content": "Reply with one short sentence."}],
                        max_tokens=1000)
print(served_by, reply.model, reply.choices[0].message.content)
```

أربع تفاصيل مهمة:

1.  **فئات الاستثناءات.** ترفع SDK الاستثناء `RateLimitError` عند 429، و`InternalServerError` عند 500 وما فوق، و`APIConnectionError` (و`APITimeoutError` فئة فرعية منه) حين يتعذر الاتصال. وكل ما عدا ذلك يُترك دون التقاط عن قصد. ولتستثني أخطاء 429 الناتجة عن حد الإنفاق، افحص `err.response` قبل أن تتابع.
2.  **قاطع الدائرة.** من دونه، يدفع كل طلب ثمن المهلة كاملة على مزوّد أساسي متعطّل قبل أن ينتقل. وبعد ثلاثة إخفاقات متتالية، يُتجاوز المزوّد الأساسي لمدة 30 ثانية. وبعدها يختبره الطلب التالي من جديد.
3.  **سجّل من خدم الطلب.** أعِد اسم المزوّد واحتفظ بـ `reply.model`. فحين تتغير الجودة، تحتاج إلى معرفة المزوّد الذي أجاب.
4.  **ميزانية الاستدلال المنطقي.** يستدل GLM 5.3 منطقيًا قبل أن يجيب. وتقول وثائق BroadNet إن الاستدلال المنطقي يُحتسب ضمن `max_tokens`، لذا اترك 1,000 أو أكثر لدى كل مزوّد.

## كيف تربط معرّفات النماذج بين المزوّدين؟

للنموذج مفتوح الأوزان نفسه معرّف مختلف لدى كل مزوّد، وقد تختلف الميزات التي يدرجها كل منهم. GLM 5.3 في 15 نوفمبر 2026:

|  | BroadNet Inference | DeepInfra | Fireworks AI |
| --- | --- | --- | --- |
| معرّف النموذج | `broadnet/glm-5.3` | `zai-org/GLM-5.3` | `accounts/fireworks/models/glm-5p3` |
| السياق | 1,048,576 رمزًا | 1,048,576 رمزًا | “1040k” رمز |
| الأدوات | موثّقة | “Function” مُدرجة | مدعومة |
| الإخراج المنظّم | موثّق | “JSON” مُدرج | لم نتحقق |

تترتب على ذلك قاعدتان. الأولى: احتفظ بجدول الربط في الإعدادات، لا مبعثرًا في الشيفرة. والثانية: طابق مزوّدك الاحتياطي مع ما تستخدمه طلباتك. ففي BroadNet، الأدوات والإخراج المنظّم موثّقة لـ GLM 5.3 وQwen3.8 27B فقط. ويستطيع وكيل يستدعي الأدوات أن ينتقل من GLM 5.3 إلى GLM 5.3 لدى مزوّد آخر، لكنه لا يستطيع بأمان أن ينتقل إلى نموذج لا يوثّق الأدوات. وإذا كانت نافذة السياق لدى الاحتياطي أصغر، فاختصر الأمر أو تجاوز ذلك الاحتياطي للطلبات الطويلة. وعناوين URL الأساسية لـ 14 مزوّدًا موجودة في [مرجع عناوين URL الأساسية](https://broadrouter.com/ar/blog/openai-compatible-api-base-urls/).

## كيف تبقي الإجابات متقاربة بعد التبديل؟

الأوزان نفسها لدى مزوّدين اثنين قد تجيب بشكل مختلف، لأن المزوّدين قد يقدّمون دقة حسابية مختلفة أو قوالب محادثة مختلفة أو معاملات افتراضية مختلفة. أما النموذج المختلف فيجيب بشكل مختلف حتمًا.

-   شغّل [مجموعة التقييم](https://broadrouter.com/ar/blog/evaluate-llm-before-switching/) على كل إدخال في القائمة، لا على المزوّد الأساسي وحده.
-   ثبّت `temperature` و`max_tokens` وأمر النظام في كل طلب، كي لا تغيّر الإعدادات الافتراضية للمزوّد الإخراج.
-   تحقق من الإخراج المنظّم بالطريقة نفسها في كل مسار. ويغطي مقال [إصلاح JSON غير الصالح](https://broadrouter.com/ar/blog/fix-invalid-json-from-llm/) حلقة الإصلاح وإعادة المحاولة.
-   فضّل النموذج نفسه لدى مزوّد آخر على نموذج مختلف لدى المزوّد نفسه. فالمستخدمون يلاحظون تغيّر الأسلوب أكثر من بضع ثوانٍ من التأخير.

## ماذا عن البث المتدفق واستدعاءات الأدوات؟

قد يفشل البث في منتصفه. وتقول وثائق BroadNet إن البث الذي ينتهي قبل `data: [DONE]` يجب أن يُعامل على أنه غير مكتمل: سجّل `X-Request-ID` وقرّر ما إذا كان تطبيقك يستطيع بأمان إرسال طلب جديد.

-   **قبل الرمز الأول:** انتقل بحرية. فالمستخدم لم يرَ شيئًا.
-   **بعد عرض رموز:** أعد التشغيل لدى الاحتياطي واستبدل الإجابة الجزئية، أو اعرض خطأ مع زر لإعادة المحاولة. فلصق نصفي إجابتين من مزوّدين مختلفين يبدو سيئًا.
-   **استدعاءات الأدوات ذات الآثار الجانبية:** لا تُعِد أبدًا تشغيل خطوة ترسل بريدًا إلكترونيًا أو تخصم من بطاقة أو تكتب في قاعدة بيانات لمجرد أن استدعاء النموذج فشل. أعطِ كل إجراء [مفتاح منع التكرار (idempotency key)](https://broadrouter.com/ar/glossary/idempotency-key/). ويغطي مقال [الوكلاء طويلو التشغيل](https://broadrouter.com/ar/blog/long-running-agents-timeouts-retries/) نقاط الحفظ.

ويشرح مقال [البث المتدفق عبر SSE](https://broadrouter.com/ar/blog/llm-streaming-sse-explained/) كيف تكتشف بثًا انتهى مبكرًا.

## كم يكلّف الانتقال التلقائي؟

-   **عمل مكرر.** انتهاء المهلة لديك لا يثبت أن المزوّد توقف. وفي الفوترة لكل رمز، كل إعادة محاولة استدلال جديد، فتوقّع أن تدفع مرتين مقابل بعض الطلبات.
-   **أسعار مختلفة.** يحتسب الاحتياطي بأسعاره هو. وقد عرضت DeepInfra سعرًا ترويجيًا لـ GLM-5.3 في 15 نوفمبر 2026، فتحقق مجددًا قبل أن تضع ميزانيتك. وتحتسب BroadNet $0.78 للإدخال، و$0.173 للإدخال المخزّن مؤقتًا، و$3.46 للإخراج لكل مليون رمز.
-   **ذاكرة مؤقتة باردة.** الإدخال المخزّن مؤقتًا لا ينتقل بين المزوّدين. فالطلبات الأولى لدى الاحتياطي تدفع سعر الإدخال الكامل على بادئة كانت مخزّنة مؤقتًا لدى الأساسي. راجع [رموز الإدخال المخزّنة مؤقتًا](https://broadrouter.com/ar/blog/cached-input-tokens-explained/).
-   **الإرسال المزدوج (hedging).** إرسال كل طلب إلى مزوّدين معًا والاحتفاظ بأول إجابة يقلّص تأخير الذيل، لكنه يضاعف الفاتورة تقريبًا. استخدمه فقط حيث يستحق التأخير ذلك.

## هل يستوفي الاحتياطي شروط البيانات نفسها؟

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

يقول [بيان الخصوصية](https://www.broadnet.ai/inference-privacy) من BroadNet: “We do not retain prompts, audio, images, answers or transcripts” (الترجمة: «لا نحتفظ بالأوامر أو الصوت أو الصور أو الإجابات أو النصوص المفرّغة»). فمحتوى الاستدلال لا يُحتفظ به؛ وتُحفظ بيانات الحساب والفوترة والأمان الوصفية الضرورية كما يصف البيان. ويقول أيضًا إن بيانات الاستدلال لا تُستخدم لتدريب النماذج أو ضبطها بدقة أو تقييمها. ويقول البيان إن النماذج المستضافة “run on BroadNet-owned or leased hardware in the United States, with partner capacity as backup” (الترجمة: «تعمل على أجهزة مملوكة لـ BroadNet أو مستأجرة في الولايات المتحدة، مع سعة لدى شركاء احتياطًا»)؛ وDeepSeek V4.1 Flash مستضاف لدى شريك. وللبيانات ذات متطلبات الإقامة، تقول الشروط (البند 7.3a) أن تتفق على مواقع المعالجة قبل إرسالها. تحقق من النقاط نفسها لدى الاحتياطي: الاحتفاظ، والاستخدام في التدريب، والموقع، والمعالجين الفرعيين. وإذا قصّر، فأبقِ الطلبات الحساسة خارج مسار الاحتياط واجعلها تفشل بإغلاق آمن. وتسرد [قائمة التحقق من عدم الاحتفاظ بالبيانات](https://broadrouter.com/ar/blog/zero-data-retention-llm-api-checklist/) الأسئلة.

## هل تستخدم بوابة مثل LiteLLM بدلًا من ذلك؟

استخدم بوابة إذا كانت عدة خدمات تحتاج إلى قواعد الاحتياط نفسها. يأخذ وكيل LiteLLM قائمة `fallbacks` تُجرَّب بالترتيب. ويعيد `num_retries` محاولة مجموعة نماذج قبل الانتقال إلى الاحتياط. ويُخرج `allowed_fails` و`cooldown_time` النشر المتعثّر من الخدمة لفترة، فيعملان عمل قاطع الدائرة. ويتعامل `context_window_fallbacks` و`content_policy_fallbacks` المنفصلان مع هذين النوعين من الأخطاء ([وثائق LiteLLM](https://docs.litellm.ai/docs/proxy/reliability)، تاريخ المراجعة 15 نوفمبر 2026):

```yaml
model_list:
  - model_name: glm
    litellm_params:
      model: openai/broadnet/glm-5.3
      api_base: https://inference.broadnet.ai/v1
      api_key: os.environ/BROADNET_API_KEY
  - model_name: glm-backup
    litellm_params:
      model: openai/zai-org/GLM-5.3
      api_base: https://api.deepinfra.com/v1/openai
      api_key: os.environ/DEEPINFRA_API_KEY

router_settings:
  fallbacks: [{"glm": ["glm-backup"]}]
  allowed_fails: 3
  cooldown_time: 30

litellm_settings:
  num_retries: 2
  request_timeout: 60
```

يعرض [دليل وكيل LiteLLM](https://broadrouter.com/ar/guides/litellm-proxy-custom-provider/) إدخال BroadNet كاملًا. ويستخدم الإدخالان البادئة العامة `openai/` في LiteLLM مع `api_base`، وهو النمط نفسه الذي يستخدمه الدليل. لكن البوابة تضيف قفزة إضافية وشيئًا آخر يجب إبقاؤه قيد التشغيل. ويكفي تطبيقًا واحدًا نحو 40 سطرًا في العميل، كما في المثال السابق.

## كيف تختبر الانتقال التلقائي قبل أن تحتاج إليه؟

1.  وجّه المزوّد الأساسي إلى مضيف لا يمكن الوصول إليه في إعدادات اختبار، وتحقق أن الطلبات تصل إلى الاحتياطي.
2.  أرسل طلبًا غير صالح عمدًا، وتحقق أنه **لا** ينتقل.
3.  استخدم مفتاحًا أساسيًا غير صالح، وتحقق أن خطأ 401 يظهر خطأً، لا تبديلًا صامتًا.
4.  راقب القاطع: بعد ثلاثة إخفاقات، يجب أن يُتجاوز المزوّد الأساسي دون انتظار المهلة.
5.  أطلق تنبيهًا حين يخدم الاحتياطي أكثر من حصة صغيرة من الحركة. فالانتقال الصامت قد يخفي مزوّدًا أساسيًا معطّلًا لأيام.

ويقبل `Router` في LiteLLM الخيار `mock_testing_fallbacks=True` في الاختبارات المباشرة لفرض الانتقال إلى الاحتياط.

## أين تقع BroadNet Inference من هذا؟

BroadRouter هو موقع BroadNet، ويمكن أن تكون BroadNet Inference أيًّا من الإدخالين في قائمتك. فبوصفها المزوّد الأساسي، تمنحك GLM 5.3 وQwen3.8 27B مع أدوات وإخراج منظّم موثّقين، إضافة إلى Gemma 4 VL 26B وDeepSeek V4.1 Flash، على [عنوان URL أساسي](https://broadrouter.com/ar/glossary/base-url/) واحد ودون احتفاظ بأي محتوى. وبوصفها احتياطيًا، فهي نقطة نهاية أخرى متوافقة مع OpenAI تضيفها إلى القائمة. وفي الحالتين، منطق الانتقال التلقائي مسؤوليتك: فـ BroadNet لا توجّه الطلبات بين المزوّدين، والخدمة الذاتية بلا SLA. وإذا احتجت إلى مستويات خدمة تعاقدية، فهي لا تتوفر إلا باتفاقية مكتوبة منفصلة. قارن [النماذج](https://broadrouter.com/ar/models/)، أو [أنشئ حسابًا](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-blog-llm-api-failover-fallback&utm_content=body) واختبر سلسلتك بالرصيد الابتدائي $5 على Gemma 4 VL 26B. أما GLM 5.3 وQwen3.8 27B فيتطلبان شحن الرصيد.

أدوات مجانية لهذا الموضوع (بالإنجليزية)

-   [OpenAI to BroadNet migration helper](https://broadrouter.com/tools/openai-to-broadnet-migration/) Paste OpenAI SDK code; get base URL, key and model edits, a diff and the checks that remain.
-   [max\_tokens calculator for reasoning models](https://broadrouter.com/tools/reasoning-token-budget/) Answer length + reasoning budget + margin = a max\_tokens that does not cut the answer off.
-   [JSON schema generator for LLM structured output](https://broadrouter.com/tools/json-schema-generator/) Sample JSON to strict schema, Pydantic, Zod and a ready request.
-   [LLM JSON output validator](https://broadrouter.com/tools/llm-json-output-validator/) Parse errors by line and column, safe repairs, cut-off detection and JSON Schema checks for model output.

[أدوات مجانية (بالإنجليزية)](https://broadrouter.com/tools/)

## مصطلحات في هذا المقال

[الرمز (التوكن، Token)](https://broadrouter.com/ar/glossary/token/)

الرمز (التوكن) هو وحدة النص التي يقرؤها نموذج اللغة ويكتبها: كلمة، أو جزء من كلمة، أو علامة ترقيم، أو تسلسل بايتات ينتجه مجزّئ النموذج (tokenizer). وتَعُدّ واجهات LLM API الاستهلاك بالرموز، وتضع حدودها بها، وتحتسب تكلفتها بها عادةً.

[استدعاء الأدوات (Tool calling)](https://broadrouter.com/ar/glossary/tool-calling/)

استدعاء الأدوات، ويُسمّى أيضًا استدعاء الدوال (function calling)، ميزة في واجهات LLM API يُرجع فيها النموذج طلبًا منظَّمًا لتشغيل دالة عرّفها المطوّر، مع معاملات بصيغة JSON. ويشغّل التطبيق الدالة ويعيد النتيجة؛ فالنموذج لا يشغّل الشيفرة بنفسه أبدًا.

[التزامن (Concurrency)](https://broadrouter.com/ar/glossary/concurrency/)

التزامن (concurrency) هو عدد الطلبات التي تكون لدى العميل قيد التنفيذ في الوقت نفسه. وكثيرًا ما تضع واجهات LLM API سقفًا له لكل مفتاح أو خطة، بمعزل عن عدد الطلبات في الدقيقة، لأن كل طلب مفتوح يشغل قدرة من وحدة GPU حتى تكتمل استجابته.

[الانتظار الأُسّي (Exponential backoff)](https://broadrouter.com/ar/glossary/exponential-backoff/)

الانتظار الأُسّي (exponential backoff) استراتيجية لإعادة المحاولة ينتظر فيها العميل مدة أطول بعد كل محاولة فاشلة، وعادةً يضاعف التأخير حتى حد أقصى، قبل أن يحاول مجددًا. وإضافة تذبذب عشوائي (jitter) إلى كل انتظار توزّع محاولات العملاء الكثيرين كي لا تصل إلى الخادم في اللحظة نفسها.

[الدفع حسب الاستخدام (Pay-as-you-go)](https://broadrouter.com/ar/glossary/pay-as-you-go/)

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

[اتفاقية مستوى الخدمة (SLA)](https://broadrouter.com/ar/glossary/sla/)

اتفاقية مستوى الخدمة (SLA) التزام تعاقدي من المزوّد بمستوى خدمة قابل للقياس، عادةً نسبة توفر شهرية، مع تعويض محدد، عادةً أرصدة خدمة، إذا لم يتحقق. وتحدد الاتفاقية ما يُعدّ توقفًا، وما هو مستثنى، وكيفية المطالبة.

[حد المعدل (Rate limit)](https://broadrouter.com/ar/glossary/rate-limit/)

حد المعدل هو سقف تفرضه واجهة API على مقدار استخدام العميل لها خلال فترة زمنية، مثل عدد الطلبات في الدقيقة أو الرموز في الدقيقة. وتُرفض الطلبات التي تتجاوزه، غالبًا بالخطأ HTTP 429 Too Many Requests، إلى أن يعود الاستخدام تحت الحد.

[مفتاح عدم التكرار (Idempotency key)](https://broadrouter.com/ar/glossary/idempotency-key/)

مفتاح عدم التكرار (idempotency key) قيمة فريدة، غالبًا معرّف عشوائي مثل UUID، يرفقها العميل بطلب يغيّر الحالة، كدفعة أو عملية شراء. فإذا أُرسل الطلب نفسه مرة أخرى بالمفتاح نفسه، أعاد الخادم النتيجة الأصلية بدل تنفيذ الإجراء مرتين.

## أسئلة شائعة

### ما الأخطاء التي يجب أن تُطلق الانتقال إلى مزوّد LLM API احتياطي؟

أخطاء الاتصال، وانتهاء المهلة، و5xx، وأخطاء 429 الناتجة عن حد المعدل، بعد إعادة المحاولة المدمجة في SDK. ولا تنتقل عند 400 أو 401 أو 402 أو 403 أو 413 أو 422: فالخطأ في الطلب أو الحساب، والمزوّد التالي سيفشل بالطريقة نفسها أو سيخفي مشكلة في الفوترة.

### هل تنتقل BroadNet تلقائيًا إلى مزوّد آخر؟

لا. لا توجّه BroadNet Inference الطلبات بين النماذج أو المزوّدين، وBroadRouter، أي هذا الموقع، هو موقع المعلومات التابع لـ BroadNet، وليس موجِّهًا. أنت من يبني البديل الاحتياطي في العميل أو في بوابة مثل LiteLLM.

### هل أستطيع استخدام معرّف النموذج نفسه لدى كل مزوّد؟

لا. يسمّي كل مزوّد النموذج مفتوح الأوزان نفسه بطريقة مختلفة. GLM 5.3 هو \`broadnet/glm-5.3\` في BroadNet، و\`zai-org/GLM-5.3\` في DeepInfra، و\`accounts/fireworks/models/glm-5p3\` في Fireworks (تاريخ المراجعة 15 نوفمبر 2026). احتفظ بجدول ربط لكل مزوّد.

### هل تكلّف المحاولات الفاشلة مالًا؟

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

### هل يجب أن تكون شروط الخصوصية لدى المزوّد الاحتياطي مماثلة؟

نعم. المزوّد الاحتياطي معالج آخر يرى الأوامر نفسها. تحقق من شروط الاحتفاظ والتدريب ومواقع المعالجة لديه قبل أن تضيفه، وإلا فإن وعدك بالخصوصية لا يصمد إلا ما دام المزوّد الأساسي يعمل.

### هل لدى BroadNet اتفاقية مستوى خدمة (SLA)؟

ليس للخدمة الذاتية. تنص شروط BroadNet (البند 7.4) على أن الخدمة الذاتية بلا التزام بالإتاحة؛ ولا توجد مستويات خدمة إلا في اتفاقية مكتوبة منفصلة.

## تابع القراءة

-   [كيف تعالج الخطأ 429 في LLM API: الانتظار المتزايد والتذبذب والمحدِّدات](https://broadrouter.com/ar/blog/handle-llm-api-429-rate-limits/)
-   [الوكلاء طويلو التشغيل: مهلات وإعادة محاولات ونقاط حفظ تصمد](https://broadrouter.com/ar/blog/long-running-agents-timeouts-retries/)
-   [عناوين base URL لواجهات API المتوافقة مع OpenAI: فحص 14 مزوّدًا](https://broadrouter.com/ar/blog/openai-compatible-api-base-urls/)
-   [مقارنة SLA لـ LLM API: بماذا تتعهد Azure وBedrock وGoogle وOpenAI؟](https://broadrouter.com/ar/blog/llm-api-sla-uptime-compared/)
-   [كيف تقيّم نموذج LLM قبل الانتقال إلى مزوّد آخر](https://broadrouter.com/ar/blog/evaluate-llm-before-switching/)
-   [عتاد GPU لدى BroadNet وطريقة تقديم النماذج، كما تصفها BroadNet](https://broadrouter.com/ar/blog/broadnet-gpu-fleet-and-serving/)
-   [تخزين استجابات LLM API مؤقتًا لخفض التكلفة: تطابق تام بـ Python](https://broadrouter.com/ar/blog/cache-llm-responses-cut-cost/)
-   [دليل: رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)
-   [دليل: توجيه LiteLLM إلى BroadNet Inference (عبر SDK والوكيل)](https://broadrouter.com/ar/guides/litellm-proxy-custom-provider/)
-   [دليل: استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)

جرّبه على مهامك الفعلية. تبدأ الحسابات الجديدة برصيد قدره $5 لاستخدام Gemma والتفريغ الصوتي. أما DeepSeek وGLM وQwen3.8 فتتطلب شحن الرصيد.

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-blog-llm-api-failover-fallback&utm_content=page-cta) ·

**المصادر**

-   [المرجع التقني لواجهة BroadNet Inference: الأخطاء وإعادة المحاولة، والحدود، والبث المتدفق، وقدرات النماذج (تاريخ المراجعة 2026-11-15) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-blog-llm-api-failover-fallback&utm_content=sources)
-   [شروط خدمة BroadNet، البندان 7.3a (مواقع المعالجة) و7.4 (الإتاحة) (تاريخ المراجعة 2026-11-15)](https://www.broadnet.ai/ar/terms)
-   [بيان خصوصية الاستدلال من BroadNet: لا احتفاظ بالمحتوى، ولا تدريب، وأجهزة في الولايات المتحدة مع سعة احتياطية لدى شركاء (تاريخ المراجعة 2026-11-15)](https://www.broadnet.ai/ar/inference-privacy)
-   [ملف README لمكتبة OpenAI Python SDK: إعادة المحاولة والمهلات وفئات الأخطاء (تاريخ المراجعة 2026-11-15)](https://github.com/openai/openai-python)
-   [وثائق LiteLLM، موثوقية الوكيل: fallbacks وnum\_retries وallowed\_fails وcooldown\_time (تاريخ المراجعة 2026-11-15)](https://docs.litellm.ai/docs/proxy/reliability)
-   [وثائق DeepInfra، نظرة عامة على المحادثة: عنوان URL أساسي متوافق مع OpenAI (تاريخ المراجعة 2026-11-15)](https://docs.deepinfra.com/chat/overview)
-   [صفحة نموذج zai-org/GLM-5.3 في DeepInfra: السياق واستدعاء الدوال ودعم JSON (تاريخ المراجعة 2026-11-15)](https://deepinfra.com/zai-org/GLM-5.3)
-   [صفحة نموذج GLM 5.3 في Fireworks AI: معرّف النموذج والسياق ودعم الأدوات (تاريخ المراجعة 2026-11-15)](https://fireworks.ai/models/fireworks/glm-5p3)
