---
title: "واجهة API متوافقة مع OpenAI: بدء سريع بـ Python وcURL"
description: "ابدأ مع واجهة API متوافقة مع OpenAI: أرسل أول طلب محادثة وأول طلب تفريغ صوتي إلى BroadNet Inference باستخدام Python أو cURL، ثم راجع قائمة التحقق للانتقال."
url: https://broadrouter.com/ar/developers/
lang: ar
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

# البدء السريع للمطوّرين

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

يستخدم BroadNet Inference صيغ طلبات OpenAI على `https://inference.broadnet.ai/v1`. أنشئ مفتاحًا في لوحة التحكم، واحفظه في متغير بيئة، ثم أرسل طلبًا إلى `/chat/completions` أو `/audio/transcriptions` مع معرّف نموذج دقيق. وقبل نقل حركة الإنتاج، تحقّق من المعاملات والبث المتدفق والأدوات والحدود والأخطاء لذلك النموذج.

-   بدء سريع: المحادثة
-   بدء سريع: التفريغ الصوتي
-   معرّفات النماذج
-   قائمة التحقق للانتقال
-   الأخطاء وإعادة المحاولة
-   المراجع والأدلة

## كيف أرسل أول طلب محادثة؟

1.  سجّل الدخول على [inference.broadnet.ai (بالإنجليزية)](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-developers&utm_content=quickstart-account) وأنشئ مفتاح استدلال. يظهر المفتاح مرة واحدة فقط، ولا تحفظ لوحة التحكم سوى بصمته (hash).
2.  ثبّت حزمة OpenAI SDK واضبط المفتاح في الطرفية. احتفظ بالمفاتيح على خادمك، ولا تضعها أبدًا في شيفرة المتصفح.
3.  أرسل الطلب. اقرأ الإجابة من `choices[0].message.content`.

setup

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

first\_request.py

```
import os
from openai import OpenAI

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)
```

request.sh

```
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"broadnet/gemma-4-26b-a4b","messages":[{"role":"user","content":"Reply with one short sentence."}]}'
```

يستخدم المثال BroadNet Gemma 4 VL 26B، الذي يغطيه الرصيد المبدئي البالغ $5. أما DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B فتتطلب شحن الرصيد أولًا. احتفظ بترويسة الاستجابة `X-Request-ID` لاستخدامها عند التواصل مع الدعم.

كيف يصل الطلب إلى النموذج

1.  01**تطبيقك**المفتاح محفوظ في متغير بيئة
    
2.  02**OpenAI SDK**يتغيّر إعدادان فقط
    
    `base_url` `api_key`
    
3.  03**BroadNet Inference**واجهة متوافقة مع OpenAI`inference.broadnet.ai/v1``POST /chat/completions`
    
4.  04**النموذج الذي تحدده**يُحدَّد في كل طلب
    
    -   `broadnet/deepseek-v4.1-flash`
    -   `broadnet/glm-5.3`
    -   `broadnet/qwen3.8-27b`
    -   `broadnet/gemma-4-26b-a4b`اختيارك
    
5.  05**الاستجابة**من ذلك النموذج
    

أنت تختار النموذج في كل طلب. لا يوجد توجيه تلقائي: يُنفَّذ الطلب على معرّف النموذج الذي أرسلته.

يستدعي تطبيقك حزمة OpenAI SDK بعنوان URL الأساسي لـ BroadNet ومفتاحك. يذهب الطلب إلى BroadNet Inference مع معرّف النموذج الذي كتبته، وذلك النموذج هو الذي يجيب. لا شيء يختار النموذج أو يبدّله نيابةً عنك.

### البث المتدفق

اضبط `stream=true` واقرأ أحداث Server-Sent Events حتى `data: [DONE]`. ومع `stream_options.include_usage` يصل استهلاك الرموز في آخر جزء. إذا انتهى البث قبل `[DONE]`، فاعتبر الإجابة غير مكتملة. تطلب BroadNet التحقق من البث المتدفق لكل نموذج قبل الاعتماد عليه في الإنتاج.

stream.sh

```
curl -N https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"broadnet/gemma-4-26b-a4b","stream":true,"stream_options":{"include_usage":true},"messages":[{"role":"user","content":"Count from one to three."}]}'
```

## كيف أفرّغ ملفًا صوتيًا؟

أرسل ملف WAV أو MP3، حتى 26,214,400 بايت للملف، إلى `/audio/transcriptions`. اضبط `language` دائمًا: فبدونه قد يعود النص العربي بحروف لاتينية. استخدم `language=ar` للعربية. حوّل ملفات `.ogg` أو `.m4a` أولًا: `ffmpeg -i voice-note.ogg -ar 16000 -ac 1 voice-note.wav`

transcribe.py

```
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)
with open("recording.wav", "rb") as audio:
    result = client.audio.transcriptions.create(
        model="broadnet/cohere-transcribe-arabic",
        file=audio,
        language="ar",
    )
print(result.text)
```

transcribe.sh

```
curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe-arabic \
  -F language=ar \
  -F file=@voice-note.wav
```

الاستجابة بصيغة JSON، والنص المفرّغ في الحقل `text`. [النموذج العربي أم متعدد اللغات، وتكلفة الصوت](https://broadrouter.com/ar/arabic-transcription/).

## ما معرّفات النماذج التي يمكنني استخدامها؟

مرّر المعرّف الدقيق في `model`. لا تعتمد على `/v1/models` لاكتشاف نماذج المحادثة؛ استخدم هذه القائمة أو [المرجع التقني (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-developers&utm_content=models-docs#models).

| النموذج | المعرّف | نقطة النهاية | المدخلات | الموثّق | الوصول |
| --- | --- | --- | --- | --- | --- |
| [DeepSeek V4.1 Flash](https://broadrouter.com/ar/models/deepseek-v4.1-flash/) | `broadnet/deepseek-v4.1-flash` | `/chat/completions` | نص + صورة | الاستدلال المنطقي | يتطلب شحن الرصيد |
| [GLM 5.3](https://broadrouter.com/ar/models/glm-5.3/) | `broadnet/glm-5.3` | `/chat/completions` | نص | الأدوات، المخرجات المنظَّمة، الاستدلال المنطقي | يتطلب شحن الرصيد |
| [Qwen3.8 27B](https://broadrouter.com/ar/models/qwen3.8-27b/) | `broadnet/qwen3.8-27b` | `/chat/completions` | نص + صورة | الأدوات، المخرجات المنظَّمة، الاستدلال المنطقي | يتطلب شحن الرصيد |
| [BroadNet Gemma 4 VL 26B](https://broadrouter.com/ar/models/gemma-4-vl-26b/) | `broadnet/gemma-4-26b-a4b` | `/chat/completions` | نص + صورة | — | الرصيد المبدئي |
| [BroadNet Transcribe Arabic](https://broadrouter.com/ar/models/cohere-transcribe-arabic/) | `broadnet/cohere-transcribe-arabic` | `/audio/transcriptions` | صوت عربي | — | الرصيد المبدئي |
| [BroadNet Transcribe](https://broadrouter.com/ar/models/cohere-transcribe/) | `broadnet/cohere-transcribe` | `/audio/transcriptions` | صوت، 14 لغةً | — | الرصيد المبدئي |

يسرد عمود «الموثّق» الأدوات والمخرجات المنظَّمة والاستدلال المنطقي التي يذكرها مرجع BroadNet لكل نموذج (تاريخ المراجعة: 2026-11-15). وتعني الشَّرطة أن المرجع لا يذكرها، لا أنها غير متوفرة.

## الانتقال من واجهة أخرى متوافقة مع OpenAI: قائمة تحقق

صيغ الطلبات مألوفة، لكن النماذج تختلف. راجع كل بند للنموذج الذي اخترته، واختبر قبل تحويل حركة الطلبات.

1.  **نقطة النهاية.** اضبط عنوان URL الأساسي على `https://inference.broadnet.ai/v1`.
2.  **المفتاح.** استخدم مفتاح استدلال من BroadNet محفوظًا في متغير بيئة. مفاتيح الخطط منفصلة عن مفاتيح الدفع حسب الاستخدام.
3.  **معرّف النموذج.** استخدم المعرّف الدقيق، مثل `broadnet/gemma-4-26b-a4b`.
4.  **المعاملات.** تأكد من أن كل معامل ترسله موثّق لذلك النموذج، واحذف ما لا يرد في توثيقه.
5.  **البث المتدفق.** تأكد من أن عميلك يقرأ SSE حتى `[DONE]` ويتعامل مع البث الذي ينتهي مبكرًا.
6.  **الأدوات والمخرجات المنظَّمة.** يوثّق المرجع هذه الميزات لـ GLM 5.3 وQwen3.8 27B. اختبر أي نموذج آخر قبل الاعتماد عليها.
7.  **الاستدلال المنطقي.** قد يستهلك الاستدلال المنطقي جزءًا من ميزانية الإخراج. اترك هامشًا في `max_tokens`؛ راجع [الإجابات الفارغة من نماذج الاستدلال](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
8.  **الحدود.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 طلبًا في الدقيقة و4 طلبات قيد التنفيذ في آنٍ واحد. وتسمح جلسة الخطة بطلب واحد في كل مرة. ويسمح مفتاح Gemma بالساعة بتدفق واحد و120 طلبًا في الدقيقة و300,000 رمز في الدقيقة.
9.  **السياق.** يشمل السياق المدخلات والإجابة معًا. راجع حد النموذج في [صفحة النموذج](https://broadrouter.com/ar/models/).
10.  **الأخطاء.** اربط رموز الحالة أدناه بإجراء إعادة المحاولة أو الإصلاح المناسب، وسجّل `X-Request-ID`.
11.  **التكاليف.** قدّر التكلفة باستخدام [حاسبات الأسعار](https://broadrouter.com/ar/pricing/). تُحتسب الصور ضمن رموز الإدخال في الدفع حسب الاستخدام.

## ما الأخطاء التي يجب إعادة المحاولة عندها؟

| الحالة | المعنى | الإجراء |
| --- | --- | --- |
| 400 / 422 | طلب أو حقل غير صالح | أصلح الطلب؛ ولا تُعِد إرساله كما هو |
| 401 | مفتاح مفقود أو غير صالح أو منتهي الصلاحية، أو حصة مستنفدة | تحقّق من المفتاح والحساب |
| 402 | `insufficient_balance` | اشحن الرصيد، ثم أعد المحاولة |
| 413 | الطلب يتجاوز حد البايتات أو النص | أرسل حجمًا أقل، كملف صوتي أصغر |
| 429 | حد المعدل أو التزامن أو معدل الرموز أو الإنفاق | انتظر مدة متزايدة لها حد أقصى، ثم أعد المحاولة |
| 500–504 | مشكلة من جهة الخادم | أعد المحاولة مع تراجع أُسّي محدود |

ملخّص من [جدول الأخطاء في المرجع التقني (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-developers&utm_content=errors-docs#errors)، تاريخ المراجعة 2026-11-15. [أمثلة شيفرة لإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).

## أين أجد المراجع والأدلة الكاملة؟

-   [**المرجع التقني للمطوّرين (بالإنجليزية)**صيغ الطلبات والحدود والأخطاء وملف الأسعار. المصدر المعتمد.](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-developers&utm_content=docs)
-   [**التكاملات (بالإنجليزية)**إعدادات Aider وCline وLangChain وn8n وLiteLLM وغيرها من الأدوات المتوافقة مع OpenAI.](https://broadrouter.com/integrations/)
-   [**الأدلة**حزم SDK والبث المتدفق وإعادة المحاولة وقوائم عناوين IP المسموح بها والكلام العربي.](https://broadrouter.com/ar/guides/)
-   [**دليل Python SDK**التثبيت وأول طلب والبث المتدفق باستخدام OpenAI Python SDK.](https://broadrouter.com/ar/guides/openai-python-sdk/)
-   [**دليل Node SDK**الخطوات نفسها بلغتي JavaScript وTypeScript، مع معرّفات الطلبات.](https://broadrouter.com/ar/guides/openai-node-sdk/)
-   [**بدء سريع مع cURL**كل الطلبات من سطر الأوامر.](https://broadrouter.com/ar/guides/curl-quickstart/)
-   [**المفاتيح وقوائم IP المسموح بها**اقصر استخدام المفاتيح على خوادمك.](https://broadrouter.com/ar/guides/api-keys-ip-allow-lists/)
-   [**منشئ طلبات API (بالإنجليزية)**أنشئ طلبًا في متصفحك وانسخه.](https://broadrouter.com/tools/api-request-builder/)

هل تحتاج إلى نقطة نهاية خاصة أو نموذج غير مدرج؟ [تواصل مع BroadNet](https://broadrouter.com/ar/contact/#private).

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

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

**المصادر**

-   [المرجع التقني للمطوّرين في BroadNet Inference (تاريخ المراجعة: 2026-11-15) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-developers&utm_content=sources)
-   [أسعار BroadNet Inference](https://inference.broadnet.ai/ar/pricing?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-developers&utm_content=sources)
-   [pricing.json، قائمة الأسعار المنشورة (بالإنجليزية)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-developers&utm_content=sources)
