---
title: "Pydantic AI مع base_url مخصّص متوافق مع OpenAI | BroadRouter"
description: "شغّل وكلاء Pydantic AI على BroadNet Inference باستخدام OpenAIChatModel وOpenAICompatibleProvider، مع استدعاء الأدوات والمخرجات المنظَّمة وضبط ملف تعريف النموذج."
url: https://broadrouter.com/ar/guides/pydantic-ai-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/pydantic-ai-openai-compatible/) (حُدّث في 2026-11-16).

# استخدام Pydantic AI مع BroadNet Inference (OpenAICompatibleProvider)

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

ثبّت pydantic-ai-slim\[openai\]، ثم أنشئ OpenAIChatModel بمعرّف نموذج من BroadNet مثل broadnet/glm-5.3 ومزوّد OpenAICompatibleProvider عنوانه الأساسي https://inference.broadnet.ai/v1 ومفتاحه مفتاح BroadNet. مرّر النموذج إلى Agent. استخدم OpenAIChatModel لا نموذج Responses، لأن BroadNet يقدّم إكمال المحادثات. وتقول وثائق Pydantic AI إن OpenAIProvider مع base\_url مخصّص لـ OpenAI نفسها.

Pydantic AI إطار عمل بلغة Python لبناء الوكلاء من فريق Pydantic. ولأي خدمة ليس لها مزوّد مدمج فيه، تقول وثائقه أن تستخدم `OpenAICompatibleProvider` مع `base_url` الخاص بالخدمة. ويقدّم BroadNet Inference إكمال المحادثات القياسي على `https://inference.broadnet.ai/v1`، فهذا هو الطريق. موقع BroadRouter هو موقع BroadNet نفسها، ويتبع هذا الدليل وثائق Pydantic AI كما هي في الإصدار 2.68.

## التثبيت

```bash
pip install "pydantic-ai-slim[openai]"
export BROADNET_API_KEY='your-broadnet-key'
```

## الاتصال

```python
import os
from pydantic_ai import Agent
from pydantic_ai.models.openai import OpenAIChatModel
from pydantic_ai.providers.openai_compatible import OpenAICompatibleProvider

model = OpenAIChatModel(
    'broadnet/glm-5.3',
    provider=OpenAICompatibleProvider(
        'broadnet',
        base_url='https://inference.broadnet.ai/v1',
        api_key=os.environ['BROADNET_API_KEY'],
    ),
)

agent = Agent(model)
result = agent.run_sync('Give me three names for a Go linting tool.')
print(result.output)
```

تشغيل هذه الشيفرة هو الاختبار: ظهور إجابة مطبوعة يعني أن المفتاح والعنوان ومعرّف النموذج صحيحة.

-   **الوسيط الأول هو معرّف النموذج** المُرسَل إلى BroadNet. استخدمه كما هو تمامًا، مع البادئة `broadnet/`.
-   **اسم المزوّد** (`'broadnet'` هنا) يُسجَّل في كل استجابة. وتقول وثائق Pydantic AI أن تُبقيه ثابتًا، لأنه يحدّد أي بيانات من الاستجابات السابقة تُعاد إلى الخدمة.
-   **ابقَ على `OpenAIChatModel`.** تقول وثائق Pydantic AI ألّا تستخدم `OpenAIResponsesModel` إلا إذا كانت الخدمة تطبّق Responses API. وBroadNet لا يدرجها.

## الأدوات والمخرجات المنظَّمة

```python
from pydantic import BaseModel

class City(BaseModel):
    name: str
    country: str

agent = Agent(model, output_type=City)
print(agent.run_sync('Which city hosts the Burj Khalifa?').output)
```

استخدم `broadnet/glm-5.3` أو `broadnet/qwen3.8-27b` للأدوات والمخرجات المنظَّمة؛ فوثائق BroadNet لا تدرج الميزتين إلا لهذين النموذجين.

## متى تضبط ملف تعريف النموذج

يختار Pydantic AI ملف تعريف الطلب (profile) بناءً على اسم النموذج. وإذا تجاهلت الخدمة ميزة أو رفضتها، تقول وثائقه أن تمرّر `OpenAIModelProfile` خاصًا بك. وهناك إعدادان يستحقان المعرفة مع BroadNet:

```python
from pydantic_ai.profiles.openai import OpenAIModelProfile

model = OpenAIChatModel(
    'broadnet/glm-5.3',
    provider=OpenAICompatibleProvider('broadnet', base_url='https://inference.broadnet.ai/v1', api_key=os.environ['BROADNET_API_KEY']),
    profile=OpenAIModelProfile(
        openai_chat_supports_max_completion_tokens=False,  # send max_tokens, the field BroadNet documents
        openai_supports_strict_tool_definition=False,      # only if strict tool schemas are rejected
    ),
)
```

مرّر حد المخرجات عبر إعدادات النموذج، مثل `agent.run_sync(prompt, model_settings={'max_tokens': 2000})`. ويُحتسب الاستدلال المنطقي ضمنه في DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B.

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

| الوكيل | النموذج |
| --- | --- |
| الأدوات والمخرجات المنظَّمة | `broadnet/glm-5.3` |
| الصور أو النصوص العربية، مع الأدوات | `broadnet/qwen3.8-27b` |
| المستندات الطويلة، خطة بسعر ثابت | `broadnet/deepseek-v4.1-flash` |
| الرصيد المبدئي المجاني | `broadnet/gemma-4-26b-a4b` (سياق 32,768 رمزًا) |

[أسعار كل النماذج](https://broadrouter.com/ar/pricing/).

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

-   **401.** المفتاح خاطئ أو منتهي الصلاحية أو استُنفدت حصته.
-   **404 أو النموذج غير موجود.** يجب أن ينتهي `base_url` بـ `/v1`. تحقّق من معرّف النموذج. تحتاج النماذج المدفوعة إلى شحن الرصيد؛ فرصيد $5 لا يغطي إلا `broadnet/gemma-4-26b-a4b` ونموذجَي Transcribe.
-   **مخرجات فارغة أو حلقة إعادة محاولة بسبب التحقق.** استهلك الاستدلال المنطقي ميزانية المخرجات. ارفع `max_tokens`. [لماذا تصل الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **400 على تعريفات الأدوات.** اضبط `openai_supports_strict_tool_definition=False` في ملف التعريف، واستخدم نموذجًا يدرج BroadNet له الأدوات.
-   **429 عند تشغيل الوكلاء بالتزامن.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).

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

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

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

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

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

الرصيد المدفوع مسبقًا هو مال يُضاف إلى حساب 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، إلى أن يعود الاستخدام تحت الحد.

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

### هل أستخدم OpenAIProvider أم OpenAICompatibleProvider مع BroadNet؟

OpenAICompatibleProvider. تقول وثائق Pydantic AI إن OpenAIProvider يقبل base\_url أيضًا، لكنه مخصّص لـ OpenAI نفسها أو لوسيط شفاف إليها، ويفترض نماذج OpenAI وميزاتها.

### لماذا OpenAIChatModel وليس نموذج OpenAI الافتراضي؟

يستخدم نموذج OpenAI الافتراضي في Pydantic AI واجهة Responses API. أما BroadNet فيقدّم إكمال المحادثات على /v1/chat/completions، وهو ما يستدعيه OpenAIChatModel.

### هل تعمل الأدوات والمخرجات المنظَّمة؟

نعم، على النموذجين اللذين يدرج BroadNet لهما الأدوات والمخرجات المنظَّمة: GLM 5.3 وQwen3.8 27B. لا تدرج وثائق BroadNet الأدوات لنموذج DeepSeek V4.1 Flash، لذا اختبر عليه الوكلاء الذين يستخدمون الأدوات أولًا.

### كيف أمنع Pydantic AI من إرسال max\_completion\_tokens؟

مرّر profile=OpenAIModelProfile(openai\_chat\_supports\_max\_completion\_tokens=False) إلى OpenAIChatModel. عندها يرسل Pydantic AI الحقل الأقدم max\_tokens، وهو الحقل الذي يصفه المرجع التقني لـ BroadNet.

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

-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)
-   [استخدام LangChain مع BroadNet Inference](https://broadrouter.com/ar/guides/langchain-openai-base-url/)
-   [استخدام CrewAI مع BroadNet Inference كنقطة نهاية OpenAI مخصّصة](https://broadrouter.com/ar/guides/crewai-custom-openai-endpoint/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)
-   [كل الأدوات التي تعمل مع 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-pydantic-ai-openai-compatible&utm_content=page-cta) ·

**المصادر**

-   [وثائق Pydantic AI، واجهات API متوافقة أخرى (نقاط نهاية أخرى، ملف تعريف النموذج) (رُوجعت في 2026-11-15)](https://pydantic.dev/docs/ai/models/compatible-apis/)
-   [وثائق Pydantic AI، نماذج OpenAI (رُوجعت في 2026-11-15)](https://pydantic.dev/docs/ai/models/openai/)
-   [PyPI، الحزمة pydantic-ai 2.68.0، Python 3.11 فأحدث (رُوجعت في 2026-11-15)](https://pypi.org/project/pydantic-ai/)
-   [المرجع التقني لـ BroadNet Inference API (رُوجع في 2026-11-15) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-pydantic-ai-openai-compatible&utm_content=sources)
