---
title: "مزوّد متوافق مع OpenAI في LiteLLM عبر api_base | BroadRouter"
description: "استدعِ BroadNet Inference عبر LiteLLM بالبادئة openai/ قبل اسم النموذج وبالمعامل api_base، في Python SDK أو في config.yaml للوكيل، مع حدود معدل مطابقة."
url: https://broadrouter.com/ar/guides/litellm-proxy-custom-provider/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# توجيه LiteLLM إلى BroadNet Inference (عبر SDK والوكيل)

آخر تحديث 2026-11-16

في LiteLLM، أضف البادئة openai/ قبل معرّف نموذج BroadNet، مثل openai/broadnet/glm-5.3، واضبط api\_base على https://inference.broadnet.ai/v1 مع مفتاح BroadNet في api\_key. وفي الوكيل (proxy)، ضع القيم نفسها تحت litellm\_params في config.yaml، وأعطِ النموذج اسمًا قصيرًا في model\_name.

يوفّر LiteLLM واجهة واحدة لكثير من مزوّدي LLM، في صورة Python SDK وفي صورة خادم وكيل (proxy). وللوصول إلى واجهة API متوافقة مع OpenAI، يطلب توثيقه أمرين: أن تضع `openai/` قبل اسم النموذج، وأن تضبط `api_base`. وBroadNet Inference تستخدم هذا المسار.

## 1\. Python SDK

```bash
pip install litellm
export BROADNET_API_KEY='your-broadnet-key'
```

```python
import os
import litellm

response = litellm.completion(
    model="openai/broadnet/glm-5.3",
    api_base="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,  # reasoning counts toward this
    messages=[{"role": "user", "content": "Name three uses of a bloom filter."}],
)
print(response.choices[0].message.content)
```

تختار `openai/` المسار، ويرسل LiteLLM المعرّف `broadnet/glm-5.3` إلى BroadNet. لا تُضف شيئًا إلى base URL؛ فعميل OpenAI داخل LiteLLM يضيف مسار نقطة النهاية بنفسه.

ينبّه توثيق LiteLLM إلى أن مسار `openai` يستخدم مكتبة OpenAI الرسمية لـ Python، وهي تحتاج إلى مفتاح API في كل طلب. مرّر `api_key` صراحةً كما في المثال، حتى لا يلجأ LiteLLM أبدًا إلى متغيّر `OPENAI_API_KEY` المخصّص لـ OpenAI نفسها. وتعود الاستجابة ببنية OpenAI، فلا يتغيّر باقي شيفرتك.

## متى تستخدم الوكيل

يكفي الـ SDK داخل تطبيق Python واحد. أما الوكيل فيفيد حين تحتاج عدة تطبيقات أو لغات برمجة إلى النماذج نفسها: فكلها تستدعي نقطة نهاية واحدة على نمط OpenAI بأسماء نماذج قصيرة، بينما يحتفظ الوكيل بمفتاح BroadNet، ويطبّق حدود المعدل، ويسجّل الاستخدام. وعندها لا تحتاج تطبيقاتك إلى أي إعدادات خاصة بـ BroadNet إطلاقًا.

## 2\. خادم الوكيل

ثبّت الإضافات الخاصة بالوكيل واكتب `config.yaml`:

```bash
pip install 'litellm[proxy]'
```

```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_GLM
      rpm: 30
  - model_name: deepseek-flash
    litellm_params:
      model: openai/broadnet/deepseek-v4.1-flash
      api_base: https://inference.broadnet.ai/v1
      api_key: os.environ/BROADNET_API_KEY_DEEPSEEK
      rpm: 30
  - model_name: qwen
    litellm_params:
      model: openai/broadnet/qwen3.8-27b
      api_base: https://inference.broadnet.ai/v1
      api_key: os.environ/BROADNET_API_KEY_QWEN
      rpm: 30

general_settings:
  master_key: os.environ/LITELLM_MASTER_KEY
```

شغّله واستدعِه كأي نقطة نهاية من OpenAI:

```bash
litellm --config config.yaml

# in a second terminal
curl http://localhost:4000/chat/completions \
  -H "Authorization: Bearer $LITELLM_MASTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "glm", "messages": [{"role": "user", "content": "Hello"}]}'
```

تخبر القيمة `os.environ/BROADNET_API_KEY_GLM` مكتبة LiteLLM بأن تقرأ ذلك المفتاح من البيئة. ويستخدم كل إدخال مفتاح دفع حسب الاستخدام خاصًا به من BroadNet، لذا فإن `rpm: 30`، وهو حد المعدل الاختياري في LiteLLM لكل عملية نشر، يطابق حد كل مفتاح. وإن اشتركت عدة إدخالات في مفتاح واحد، فإنها تتقاسم ذلك الحد الواحد، لذا وزّع الرقم بينها. ويجعل `master_key` الوكيل يشترط مفتاحًا في كل استدعاء؛ ويقول توثيق LiteLLM إنه يجب أن يبدأ بـ `sk-`. صدّر `LITELLM_MASTER_KEY` قبل تشغيل الوكيل.

## أي نموذج تختار

| model\_name | نموذج BroadNet | الاستخدام |
| --- | --- | --- |
| `glm` | [GLM 5.3](https://broadrouter.com/ar/models/glm-5.3/) | الأدوات، والمخرجات المنظَّمة، وسياق مليون رمز |
| `deepseek-flash` | [DeepSeek V4.1 Flash](https://broadrouter.com/ar/models/deepseek-v4.1-flash/) | السياق الطويل؛ نموذج الخطة غير المحدودة |
| `qwen` | [Qwen3.8 27B](https://broadrouter.com/ar/models/qwen3.8-27b/) | الصور، والأدوات، والعربية |
| (أضفه عند الحاجة) | [Gemma 4 VL 26B](https://broadrouter.com/ar/models/gemma-4-vl-26b/) | سعر منخفض لكل رمز؛ يعمل بالرصيد البالغ $5 |

الأسعار في [صفحة الأسعار](https://broadrouter.com/ar/pricing/). وإن كنت تنتقل من بوابة أخرى، فإن [قائمة التحقق للانتقال](https://broadrouter.com/ar/blog/openai-compatible-api-migration-checklist/) تغطي ما ينبغي اختباره.

## حل المشكلات

-   **401.** مفتاح BroadNet خاطئ أو منتهي الصلاحية أو استنفد رصيد الدفع حسب الاستخدام. وإن كان الخطأ 401 صادرًا من الوكيل نفسه، فافحص مفتاح LiteLLM الذي أرسلته بدلًا من ذلك.
-   **Not Found.** تأكّد أن `api_base` هو `https://inference.broadnet.ai/v1` مع `/v1`. وإن كان base URL صحيحًا، فتحقّق من أن معرّف النموذج بعد `openai/` يطابق معرّف BroadNet تمامًا.
-   **رفض النموذج على حساب جديد.** تحتاج GLM 5.3 وQwen3.8 27B وDeepSeek V4.1 Flash إلى شحن الرصيد أولًا؛ والرصيد البالغ $5 يغطي `broadnet/gemma-4-26b-a4b` ونموذجَي Transcribe فقط.
-   **محتوى فارغ.** يُحتسب الاستدلال المنطقي ضمن `max_tokens`. ارفعه أو أرسل `reasoning_effort="low"`. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **429.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 في آنٍ واحد. يساعد `rpm` في LiteLLM على الحد الأول؛ أما الثاني فأبقِ عدد المستدعين المتزامنين عند 4 أو أقل لكل مفتاح. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).
-   **وكلاء متوازون على مفتاح خطة.** [جلسة الخطة](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/) الواحدة تشغّل طلبًا واحدًا في كل مرة. وتشغيل عدة وكلاء عبر الوكيل (proxy) على جلسة واحدة يجعلهم ينتظرون في طابور؛ اشترِ جلسة لكل وكيل متوازٍ.

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

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

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

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

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

[العنوان الأساسي (Base URL)](https://broadrouter.com/ar/glossary/base-url/)

العنوان الأساسي (base URL) هو الجذر الثابت لعنوان الواجهة، مثل https://api.example.com/v1، الذي يضعه العميل قبل كل مسار نقطة نهاية، مثل /chat/completions. وفي حزم SDK المتوافقة مع OpenAI، يكفي تغيير العنوان الأساسي، مع مفتاح API ومعرّف النموذج، لتوجيه الشيفرة نفسها إلى مزوّد آخر.

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

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

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

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

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

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

[الرصيد المدفوع مسبقًا (Prepaid credit)](https://broadrouter.com/ar/glossary/prepaid-credit/)

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

[مفتاح API (API key)](https://broadrouter.com/ar/glossary/api-key/)

مفتاح API هو سلسلة نصية سرية تعرّف العميل الذي يستدعي الواجهة وتخوّله. تتوقعه واجهات LLM API عادةً في الترويسة Authorization: Bearer، وكل من يملك المفتاح يستطيع إرسال طلبات تُحتسب تكلفتها على الحساب المالك له.

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

### لماذا يُرجع LiteLLM الخطأ Not Found؟

يوصي توثيق LiteLLM بالتأكد من أن api\_base ينتهي بـ /v1. استخدم https://inference.broadnet.ai/v1 ولا تُضف /chat/completions.

### لماذا اسم النموذج openai/broadnet/glm-5.3؟

تخبر البادئة openai/ مكتبة LiteLLM بأن تستدعي نقطة نهاية /chat/completions على نمط OpenAI. يستخدم LiteLLM البادئة لاختيار المسار ويرسل الباقي، أي broadnet/glm-5.3، وهو معرّف النموذج في BroadNet.

### هل يمكن وضع مفتاح خطة BroadNet غير المحدودة خلف وكيل LiteLLM مشترك؟

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

### هل يحتاج LiteLLM إلى OPENAI\_API\_KEY لاستدعاء BroadNet؟

يحتاج مسار openai إلى مفتاح في كل طلب، إما من api\_key أو من OPENAI\_API\_KEY. مرّر مفتاح BroadNet في api\_key، أو os.environ/BROADNET\_API\_KEY في الوكيل، حتى لا يرسل LiteLLM مفتاح OpenAI حقيقيًا إلى BroadNet.

## أدلة ذات صلة

-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)
-   [استخدام LangChain مع BroadNet Inference](https://broadrouter.com/ar/guides/langchain-openai-base-url/)
-   [كل الأدوات التي تعمل مع BroadNet Inference (بالإنجليزية)](https://broadrouter.com/integrations/): حِزم SDK ووكلاء البرمجة وواجهات الدردشة وأدوات الأتمتة، مع الإعدادات الدقيقة لكل منها

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

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-litellm-proxy-custom-provider&utm_content=page-cta) ·

**المصادر**

-   [توثيق LiteLLM، نقاط النهاية المتوافقة مع OpenAI (رُوجع في 2026-11-14)](https://docs.litellm.ai/docs/providers/openai_compatible)
-   [توثيق LiteLLM، ملف config.yaml للوكيل (رُوجع في 2026-11-14)](https://docs.litellm.ai/docs/proxy/configs)
-   [المرجع التقني لـ BroadNet Inference API (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-litellm-proxy-custom-provider&utm_content=sources)
