---
title: "Instructor مع base_url متوافق مع OpenAI (Pydantic) | BroadRouter"
description: "استخرج كائنات Pydantic من BroadNet Inference باستخدام Instructor، عبر from_openai أو from_provider مع base_url مخصّص، واختر وضع Mode المناسب."
url: https://broadrouter.com/ar/guides/instructor-structured-output/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# مخرجات منظَّمة باستخدام Instructor على BroadNet Inference

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

غلّف عميل OpenAI مضبوطًا على base\_url هو https://inference.broadnet.ai/v1 ومفتاح BroadNet بالدالة instructor.from\_openai، ثم استدعِ chat.completions.create مع response\_model على صنف Pydantic الخاص بك، وmodel على broadnet/glm-5.3 أو broadnet/qwen3.8-27b. هذان هما النموذجان اللذان تُدرج لهما BroadNet الأدوات والمخرجات المنظَّمة. الوضع الافتراضي Mode.TOOLS، ويعمل Mode.JSON\_SCHEMA أيضًا.

Instructor مكتبة Python تحوّل ردود نماذج LLM إلى كائنات Pydantic متحقَّق منها، ويمكنها إعادة المحاولة حين يفشل التحقق. وهي تعدّل عميل OpenAI (patch)، ويغطي توثيقها الخوادم المتوافقة مع OpenAI عبر `base_url`. وBroadNet Inference تقدّم chat completions على `https://inference.broadnet.ai/v1`، وتُدرج الأدوات والمخرجات المنظَّمة لنموذجَي GLM 5.3 وQwen3.8 27B. BroadRouter هو موقع BroadNet نفسها؛ ويتبع هذا الدليل توثيق Instructor كما هو في الإصدار 1.17.0.

## التثبيت

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

## استخراج كائن

```python
import os
import instructor
from openai import OpenAI
from pydantic import BaseModel

class Invoice(BaseModel):
    vendor: str
    total: float
    currency: str

client = instructor.from_openai(
    OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"]),
    mode=instructor.Mode.TOOLS,
)

invoice = client.chat.completions.create(
    model="broadnet/glm-5.3",
    response_model=Invoice,
    max_tokens=4000,
    messages=[{"role": "user", "content": "Acme Trading invoice, total 1,250.00 SAR"}],
)
print(invoice)
```

يحوّل Instructor الصنف `Invoice` إلى مخطط أداة، ويُلزم النموذج باستدعائها عبر `tool_choice`، ثم يتحقق من الوسائط. ومرّر `max_retries` لتتحكم في عدد المرات التي يعيد فيها الطلب، مع رسالة خطأ التحقق، حين لا يجتاز الكائن التحقق.

## أو استخدم from\_provider

```python
pclient = instructor.from_provider(
    "openai/broadnet/glm-5.3",
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
invoice = pclient.create(response_model=Invoice, max_tokens=4000,
                         messages=[{"role": "user", "content": "Acme Trading, 1,250.00 SAR"}])
```

الجزء `openai/` يحدّد العميل، والباقي، أي `broadnet/glm-5.3`، يُرسَل كمعرّف النموذج.

## أي وضع تختار

| الوضع | ما يرسله | الاستخدام مع BroadNet |
| --- | --- | --- |
| `Mode.TOOLS` (الافتراضي) | استدعاء أداة إلزامي بمخططك | نعم، على GLM 5.3 أو Qwen3.8 27B |
| `Mode.JSON_SCHEMA` | `response_format` من نوع `json_schema` | نعم، على GLM 5.3 أو Qwen3.8 27B |
| `Mode.MD_JSON` | طلب عادي؛ ويُحلَّل JSON من النص | بديل احتياطي للنماذج الأخرى؛ اختبره أولًا |
| `Mode.RESPONSES_TOOLS` | Responses API | لا: BroadNet تقدّم chat completions |

## الصور

يقبل Qwen3.8 27B الصور إلى جانب الأدوات، فيستطيع قراءة صورة أو مستند ممسوح ضوئيًا مباشرة إلى نموذج Pydantic الخاص بك:

```python
import base64
img = base64.b64encode(open("invoice.jpg", "rb").read()).decode()
invoice = client.chat.completions.create(
    model="broadnet/qwen3.8-27b",
    response_model=Invoice,
    max_tokens=4000,
    messages=[{"role": "user", "content": [
        {"type": "text", "text": "Extract the invoice fields."},
        {"type": "image_url", "image_url": {"url": "data:image/jpeg;base64," + img}},
    ]}],
)
```

على مفتاح الدفع حسب الاستخدام، تُحتسب الصورة رموز إدخال. راجع [قراءة الفواتير العربية بالرؤية الحاسوبية](https://broadrouter.com/ar/guides/read-arabic-invoices-with-vision/).

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

في 2026-11-15 ثبّتنا instructor 1.17.0 مع openai 3.3.0 في بيئة افتراضية نظيفة، وشغّلنا الأمثلة أعلاه على خادم وهمي (mock) محلي يتحدث بنية chat completions الخاصة بـ BroadNet، ثم قرأنا الطلبات المسجّلة. أرسل `Mode.TOOLS` المخطط كأداة مع `tool_choice` إلزامي، وأرسل `Mode.JSON_SCHEMA` صيغة استجابة `json_schema`، وأعاد كلاهما كائن `Invoice` صالحًا. وأرسل `from_provider` معرّف النموذج دون تغيير. خادمنا الوهمي لا يكتب JSON في نص حر، لذا لم نختبر `Mode.MD_JSON`، ولم نرسل مثال الصورة. لم يكن لدينا مفتاح BroadNet، لذا لم نختبر مخرجات نموذج حقيقية.

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

-   **إعادات تحقق لا تنجح أبدًا.** يُحتسب الاستدلال المنطقي ضمن `max_tokens` في GLM 5.3 وQwen3.8 27B، وقد يقطع الحد المنخفض وسائط الأداة. ارفعه. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **400 على الطلب.** تأكّد أنك تستخدم GLM 5.3 أو Qwen3.8 27B. وإن رُفض `tool_choice` الإلزامي، فجرّب `Mode.JSON_SCHEMA`.
-   **401.** المفتاح خاطئ أو منتهي الصلاحية أو استنفد رصيده.
-   **404.** يجب أن ينتهي `base_url` بـ `/v1`. ويحتاج GLM 5.3 وQwen3.8 27B إلى شحن الرصيد؛ فالرصيد البالغ $5 لا يغطيهما.
-   **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 حتى تكتمل استجابته.

[الذكاء الاصطناعي متعدد الوسائط (Multimodal AI)](https://broadrouter.com/ar/glossary/multimodal/)

الذكاء الاصطناعي متعدد الوسائط هو نموذج أو نظام يتعامل مع أكثر من نوع من البيانات، مثل النص والصور والفيديو والصوت. فقد يقرأ النموذج متعدد الوسائط صورة وسؤالًا معًا، أو يستقبل كلامًا ويجيب نصًا. والنموذج اللغوي البصري هو أشهر أنواعه.

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

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

### أي وضع من Instructor أستخدم مع BroadNet؟

الوضع Mode.TOOLS، وهو الافتراضي، على GLM 5.3 أو Qwen3.8 27B، وهما النموذجان اللذان تُدرج لهما BroadNet الأدوات والمخرجات المنظَّمة. أما Mode.JSON\_SCHEMA فيرسل response\_format من نوع json\_schema بدلًا من ذلك. وقد أنتج كلاهما كائنات صالحة في اختبارنا على خادم وهمي (mock).

### هل يمكنني استخدام Mode.RESPONSES\_TOOLS؟

لا. يقول توثيق Instructor ألا تختاره ما لم يكن الخادم يطبّق Responses API. وBroadNet تقدّم chat completions فقط.

### هل يعمل Instructor مع DeepSeek V4.1 Flash أو Gemma على BroadNet؟

لا تُدرج BroadNet الأدوات ولا المخرجات المنظَّمة لهذين النموذجين. الوضع Mode.MD\_JSON يطلب JSON في نص عادي ثم يحلّله، وقد ينجح، لكن اختبره على بياناتك قبل الاعتماد عليه.

### كيف أكتب سلسلة النموذج في from\_provider؟

اكتب openai/broadnet/glm-5.3. يفصل Instructor المقطع الأول بوصفه المزوّد، وفي اختبارنا أرسل broadnet/glm-5.3 إلى الخادم دون تغيير.

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

-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)
-   [استخدام Pydantic AI مع BroadNet Inference (OpenAICompatibleProvider)](https://broadrouter.com/ar/guides/pydantic-ai-openai-compatible/)
-   [قراءة الفواتير والإيصالات العربية بنموذج رؤية](https://broadrouter.com/ar/guides/read-arabic-invoices-with-vision/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](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-instructor-structured-output&utm_content=page-cta) ·

**المصادر**

-   [توثيق Instructor، صفحة OpenAI والخوادم المتوافقة مع OpenAI (رُوجع في 2026-11-15)](https://python.useinstructor.com/integrations/openai/)
-   [PyPI، الحزمة instructor 1.17.0 (رُوجع في 2026-11-15)](https://pypi.org/project/instructor/)
-   [المرجع التقني لـ BroadNet Inference API (رُوجع في 2026-11-15) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-instructor-structured-output&utm_content=sources)
