---
title: "OpenAI Python SDK مع base_url مخصّص (BroadNet) | BroadRouter"
description: "وجّه حزمة OpenAI Python SDK الرسمية إلى BroadNet Inference بتغيير base_url فقط: التثبيت وضبط المفتاح وأول طلب وبث الإجابة."
url: https://broadrouter.com/ar/guides/openai-python-sdk/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# استخدام OpenAI Python SDK مع BroadNet Inference

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

ثبّت الحزمة openai، ثم أنشئ العميل مع ضبط base\_url على https://inference.broadnet.ai/v1 ووضع مفتاح BroadNet في api\_key. تعمل كل استدعاءات chat.completions دون تعديل؛ يتغيّر معرّف النموذج فقط، مثل broadnet/deepseek-v4.1-flash. يقدّم BroadNet إكمال المحادثات والتفريغ الصوتي، لا Responses API.

تحتاج إلى حساب في BroadNet Inference ومفتاح استدلال. تبدأ الحسابات الجديدة برصيد قدره $5 دون بطاقة دفع؛ [أنشئ حسابًا على inference.broadnet.ai](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-openai-python-sdk&utm_content=body). تعرض لوحة التحكم المفتاح مرة واحدة فقط، ولا تحفظ سوى بصمته (hash)، فانسخه مباشرة إلى متغيرات البيئة لديك.

## 1\. ثبّت الحزمة واضبط المفتاح

تتطلب الحزمة الحالية `openai` (الإصدار 3.x) الإصدار Python 3.10 أو أحدث.

```bash
python -m pip install openai
export BROADNET_API_KEY='paste-the-key-once'
```

## 2\. أرسل أول طلب

احفظ ما يلي في الملف `first_request.py`:

```python
from openai import OpenAI
import os

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

response = client.chat.completions.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Reply with one short sentence."}],
)
print(response.choices[0].message.content)
```

شغّله بالأمر `python first_request.py`. يستخدم هذا المثال `broadnet/gemma-4-26b-a4b` لأنه يعمل بالرصيد المجاني. أما نماذج المحادثة الأخرى فتتاح بعد شحن الرصيد.

## 3\. انتقل إلى النموذج الذي تريده

غيّر `model` فقط:

| ما تريده | معرّف النموذج |
| --- | --- |
| استخدام غير محدود بخطة ثابتة السعر، وسياق 1M | `broadnet/deepseek-v4.1-flash` |
| الأدوات والمخرجات المنظَّمة، وسياق 1M | `broadnet/glm-5.3` |
| النصوص العربية والصور | `broadnet/qwen3.8-27b` |
| سعر منخفض، ويعمل بالرصيد المجاني | `broadnet/gemma-4-26b-a4b` |

تُجري نماذج DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B استدلالًا منطقيًا قبل أن تجيب، ويُحتسب هذا الاستدلال ضمن `max_tokens`. امنحها 1,000 رمز (توكن) أو أكثر. [إليك لماذا يُرجع الحد الصغير إجابة فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).

## 4\. بثّ الإجابة

```python
stream = client.chat.completions.create(
    model="broadnet/deepseek-v4.1-flash",
    stream=True,
    stream_options={"include_usage": True},
    messages=[{"role": "user", "content": "Count from one to three."}],
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if chunk.usage:
        print("\n", chunk.usage)
```

مع `include_usage` تصل أعداد الرموز في آخر جزء، وهو جزء لا يحتوي على `choices`. ويتناول [دليل البث المتدفق](https://broadrouter.com/ar/guides/streaming-chat-completions/) حالات انقطاع الاتصال.

## 5\. احتفظ بمعرّف الطلب

تحمل كل استجابة الترويسة `X-Request-ID`. سجّلها، فدعم BroadNet يطلبها. وتعرضها الاستجابات المحلَّلة في `response._request_id`. ولقراءتها مع الترويسات الأخرى:

```python
raw = client.chat.completions.with_raw_response.create(
    model="broadnet/gemma-4-26b-a4b",
    messages=[{"role": "user", "content": "Hi"}],
)
print(raw.headers.get("x-request-id"))
response = raw.parse()
```

يسمح مفتاح الدفع حسب الاستخدام بما يصل إلى 30 من الطلبات في الدقيقة و4 من الطلبات قيد التنفيذ في آنٍ واحد. [ما معنى كل رمز خطأ ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).

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

-   **`AuthenticationError` (401).** المفتاح خاطئ أو منتهي الصلاحية، أو استُنفدت حصة الدفع حسب الاستخدام. تأكّد من ضبط `BROADNET_API_KEY` في العملية التي تشغّل شيفرتك.
-   **`NotFoundError` (404).** تأكّد من أن `base_url` ينتهي بـ `/v1`، وأنك تستدعي `chat.completions` لا `responses`. ثم تحقّق من معرّف النموذج مع البادئة `broadnet/`.
-   **فشل نموذج مدفوع على حساب جديد.** يغطي الرصيد المبدئي البالغ $5 نموذج BroadNet Gemma 4 VL 26B (`broadnet/gemma-4-26b-a4b`) ونموذجَي BroadNet Transcribe. اشحن رصيدك لاستخدام نماذج المحادثة الأخرى: DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B.
-   **`content` فارغ.** يُحتسب الاستدلال المنطقي ضمن `max_tokens`. ارفعه إلى 1,000 أو أكثر. [لماذا تصل الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **`RateLimitError` (429).** تجاوزت الحد في الدقيقة أو حد التزامن. تعيد حزمة SDK المحاولة مرتين افتراضيًا؛ اضبط `max_retries` على العميل لتغيير ذلك.
-   **أخطاء في عميل HTTP مخصّص بعد الترقية.** تستخدم حزمة SDK في الإصدار 3.x مكتبة HTTPX2. إذا كنت تمرّر `http_client` خاصًا بك، فاتبع دليل الانتقال إلى HTTPX2 الخاص بالحزمة.

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

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

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

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

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

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

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

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

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

[البث المتدفق (Streaming)](https://broadrouter.com/ar/glossary/streaming/)

البث المتدفق (streaming) طريقة لإرجاع استجابة النموذج اللغوي على أجزاء صغيرة أثناء توليدها، بدل إرجاعها ردًا واحدًا في النهاية. وتبث الواجهات المتوافقة مع OpenAI عبر أحداث يرسلها الخادم (server-sent events) حين يضبط الطلب stream على true.

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

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

### هل أحتاج إلى حزمة SDK مختلفة؟

لا. يتعامل BroadNet Inference بصيغ OpenAI لإكمال المحادثات وتفريغ الصوت، لذا تعمل الحزمة الرسمية openai بمجرد تغيير base\_url.

### هل يمكنني الاستمرار في استخدام OPENAI\_API\_KEY؟

يمكنك ذلك، لكن متغيرًا منفصلًا باسم BROADNET\_API\_KEY يجنّبك إرسال مفتاح مزوّد إلى مزوّد آخر بالخطأ.

### هل تقرأ حزمة SDK المتغير OPENAI\_BASE\_URL؟

نعم. إذا لم تمرّر base\_url، يستخدم العميل OPENAI\_BASE\_URL. اضبطه على https://inference.broadnet.ai/v1، واضبط OPENAI\_API\_KEY على مفتاح BroadNet، وعندها لا يحتاج OpenAI() إلى أي وسائط.

### هل يمكنني استخدام client.responses.create مع BroadNet؟

لا. يبدأ ملف README الخاص بالحزمة بـ Responses API، لكن وثائق BroadNet لا تذكر سوى إكمال المحادثات وتفريغ الصوت. استخدم client.chat.completions.create.

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

-   [استخدام OpenAI Node.js SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-node-sdk/)
-   [البث المتدفق لإكمال المحادثات والتعامل مع انقطاع الاتصال](https://broadrouter.com/ar/guides/streaming-chat-completions/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)

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

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

**المصادر**

-   [المرجع التقني لـ BroadNet Inference API، أول طلب (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-openai-python-sdk&utm_content=sources#base-url)
-   [مكتبة OpenAI لـ Python على PyPI (الإصدار 3.x، Python 3.10 فأحدث، رُوجع في 2026-11-14)](https://pypi.org/project/openai/)
