---
title: "الفئة dspy.LM في DSPy مع api_base متوافق مع OpenAI | BroadRouter"
description: "اضبط dspy.LM على BroadNet Inference بالبادئة openai/ وapi_base وmodel_type=\"chat\"، لأن DSPy 3.5 يرسل نماذج OpenAI إلى Responses API."
url: https://broadrouter.com/ar/guides/dspy-openai-compatible/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# استخدام DSPy مع BroadNet Inference (اضبط model\_type="chat")

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

أنشئ dspy.LM بالنموذج "openai/broadnet/glm-5.3" وmodel\_type="chat" وapi\_base بقيمة https://inference.broadnet.ai/v1 ومفتاح api\_key من BroadNet، ثم مرّره إلى dspy.configure. الجزء model\_type="chat" مهم: يوجّه DSPy 3.5 افتراضيًا النماذج ذات البادئة openai إلى Responses API، التي لا تخدمها BroadNet. في اختبارنا على خادم وهمي، أدى حذفه إلى استدعاء /v1/responses الذي أعاد الخطأ 404، ونقطة نهاية BroadNet الفعلية ترد على هذا المسار أيضًا بالخطأ 404.

DSPy إطار عمل بلغة Python لبرمجة النماذج اللغوية بالتواقيع (signatures) والوحدات (modules)، ولتحسين التعليمات (prompts) التي تقف خلفها. تربطه بنموذج عبر `dspy.LM`. ويعرض توثيق DSPy الخوادم المتوافقة مع OpenAI على شكل نموذج `openai/` مع `api_base`. ومع BroadNet Inference، التي تخدم chat completions على `https://inference.broadnet.ai/v1`، تحتاج أيضًا إلى `model_type="chat"`. BroadRouter هو موقع BroadNet نفسها؛ ويتبع هذا الدليل توثيق DSPy للإصدار 3.5.

## التثبيت

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

## الاتصال

```python
import os
import dspy

lm = dspy.LM(
    "openai/broadnet/glm-5.3",
    model_type="chat",
    api_base="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,
)
dspy.configure(lm=lm)

qa = dspy.Predict("question -> answer")
print(qa(question="What is the capital of Saudi Arabia?").answer)
```

-   **`openai/`** يطلب من DSPy استخدام عميل OpenAI. وبقية السلسلة، `broadnet/glm-5.3`، هي معرّف النموذج المرسل إلى BroadNet.
-   **`model_type="chat"`** يُبقي DSPy على `/v1/chat/completions`. ويقول مرجع LM في DSPy إن القيمة الافتراضية `'auto'` تجعل نماذج OpenAI “use Responses” (ترجمة: تستخدم Responses).
-   **`max_tokens`** يترك مساحة للاستدلال المنطقي. فنماذج DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B تفكّر قبل أن تجيب، والتفكير يُحتسب ضمن الحد.

## ماذا يحدث من دون model\_type

المثال الموجود في صفحة التثبيت في DSPy لخادم متوافق مع OpenAI لا يتضمن `model_type`. في اختبارنا مع DSPy 3.5.0، أرسل ذلك الطلب إلى `/v1/responses` مع `max_output_tokens`، ففشل الاستدعاء:

```text
dspy.utils.exceptions.LMInvalidRequestError: [openai/broadnet/glm-5.3] /v1/responses not served
```

جاء هذا الخطأ من الخادم الوهمي (mock) الذي استخدمناه. ونقطة نهاية BroadNet الفعلية ردّت أيضًا على `/v1/responses` بالخطأ 404 عندما تحققنا في 2026-11-16. وإضافة `model_type="chat"` أصلحت المشكلة.

## الوحدات والنماذج

```python
cot = dspy.ChainOfThought("question -> answer")
print(cot(question="A train leaves at 9:40 and arrives at 13:05. How long is the trip?").answer)
```

| استخدام DSPy | النموذج |
| --- | --- |
| `Predict` و`ChainOfThought` وتشغيلات المحسّن | `broadnet/deepseek-v4.1-flash` (سعر منخفض لكل رمز؛ خطط ثابتة السعر) |
| `ReAct` والوحدات الأخرى التي تستدعي الأدوات | `broadnet/glm-5.3` أو `broadnet/qwen3.8-27b` |
| تجربة DSPy بالرصيد المبدئي | `broadnet/gemma-4-26b-a4b` (سياق 32,768 رمزًا) |

يُدرج توثيق BroadNet الأدوات والمخرجات المنظَّمة لنموذجَي GLM 5.3 وQwen3.8 27B فقط. ويمكنك استخدام نموذج للبرنامج وآخر للمحسّن، لكل منهما `dspy.LM` خاص به. [أسعار كل النماذج](https://broadrouter.com/ar/pricing/).

## كيف اختبرنا هذا

في 2026-11-15 ثبّتنا dspy 3.5.0 في بيئة افتراضية نظيفة، وشغّلنا `dspy.Predict` على خادم وهمي محلي يتحدث بنية chat completions الخاصة بـ BroadNet ويرد على `/v1/responses` بالخطأ 404. من دون `model_type`، استدعى DSPy المسار `/v1/responses` وفشل. ومع `model_type="chat"`، استدعى `/v1/chat/completions` بمعرّف النموذج `broadnet/glm-5.3` ومفتاح Bearer، وحلّل حقل الإجابة. ولاحظنا أن DSPy أرسل حد المخرجات في الحقل `max_completion_tokens`. أما المرجع التقني لـ BroadNet API فيصف الحقل `max_tokens` ولا يذكر `max_completion_tokens`، لذا لا يمكننا تأكيد أن BroadNet تطبّق حدًا يُرسَل بهذه الطريقة. واختبرنا على خادم وهمي لا بمفتاح BroadNet، لذا لم نتحقق من مخرجات نموذج حقيقية.

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

-   **404 على /v1/responses.** أضف `model_type="chat"`.
-   **404 على /v1/chat/completions.** يجب أن ينتهي `api_base` بـ `/v1`، وأن يكون اسم النموذج هو `openai/` متبوعًا بمعرّف BroadNet الكامل. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ والرصيد البالغ $5 يغطي `broadnet/gemma-4-26b-a4b` ونموذجَي Transcribe فقط.
-   **“Expected to find output fields”.** (ترجمة: كان متوقعًا العثور على حقول المخرجات.) كانت الإجابة فارغة أو مبتورة، غالبًا لأن الاستدلال المنطقي استنفد ميزانية المخرجات. ارفع `max_tokens`. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **429 أثناء التحسين.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. خفّض عدد خيوط المحسّن وراجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).

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

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

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

[Chat Completions API (واجهة إكمال المحادثة)](https://broadrouter.com/ar/glossary/chat-completions-api/)

Chat Completions API هي نقطة نهاية HTTP لدى OpenAI، أي POST /v1/chat/completions، تستقبل اسم نموذج وقائمة رسائل موسومة بأدوارها وتُرجع الرسالة التالية من النموذج. وصارت بنية طلبها واستجابتها الصيغة المشتركة التي يعيد استخدامها المزوّدون المتوافقون مع OpenAI وحزم SDK.

[استدعاء الأدوات (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 حتى تكتمل استجابته.

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

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

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

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

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

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

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

### لماذا يستدعي DSPy المسار /v1/responses على BroadNet؟

يقول مرجع dspy.LM في DSPy 3.5 إن قيمة model\_type الافتراضية 'auto' تجعل نماذج OpenAI تستخدم Responses API. ويُعامَل نموذج openai/ مع api\_base مخصّص بالطريقة نفسها. مرّر model\_type="chat" لاستخدام chat completions، وهي ما تخدمه BroadNet.

### كيف أكتب معرّف نموذج BroadNet في DSPy؟

ضع openai/ قبل معرّف BroadNet، مثل openai/broadnet/glm-5.3. يستخدم DSPy البادئة openai/ لاختيار العميل، وفي اختبارنا أرسل broadnet/glm-5.3 على أنه النموذج.

### أي نموذج من BroadNet يناسب محسّنات DSPy؟

تُجري المحسّنات استدعاءات كثيرة، فالتكلفة وحدود المعدل مهمة. نموذج DeepSeek V4.1 Flash سعره منخفض لكل رمز، وهو النموذج المتاح في خطط BroadNet ثابتة السعر التي لا تُحتسب بالرمز. واستخدم GLM 5.3 أو Qwen3.8 27B للوحدات التي تستدعي الأدوات، مثل ReAct.

### هل تؤثر ذاكرة DSPy المؤقتة عند العمل مع BroadNet؟

يخزّن DSPy استدعاءات النموذج مؤقتًا افتراضيًا (cache=True)، فتكرار الاستدعاء نفسه لا يكلّف شيئًا. اضبط cache=False أثناء التحقق من الاتصال، وإلا فقد تنظر إلى إجابة مخزّنة مؤقتًا.

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

-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)
-   [توجيه LiteLLM إلى BroadNet Inference (عبر SDK والوكيل)](https://broadrouter.com/ar/guides/litellm-proxy-custom-provider/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)
-   [كل الأدوات التي تعمل مع 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-dspy-openai-compatible&utm_content=page-cta) ·

**المصادر**

-   [توثيق DSPy، التثبيت وإعداد النموذج اللغوي (صفحة مؤرخة 2026-11-10، رُوجعت في 2026-11-15)](https://dspy.ai/current/getting-started/installation/)
-   [توثيق DSPy، مرجع dspy.LM API (model\_type) (رُوجع في 2026-11-15)](https://dspy.ai/current/api/models/LM/)
-   [PyPI، الحزمة dspy 3.5.0 (رُوجع في 2026-11-15)](https://pypi.org/project/dspy/)
-   [المرجع التقني لـ BroadNet Inference API (رُوجع في 2026-11-16) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-dspy-openai-compatible&utm_content=sources)
