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

- سجّل الدخول على inference.broadnet.ai (بالإنجليزية) وأنشئ مفتاح استدلال. يظهر المفتاح مرة واحدة فقط، ولا تحفظ لوحة التحكم سوى بصمته (hash).
- ثبّت حزمة OpenAI SDK واضبط المفتاح في الطرفية. احتفظ بالمفاتيح على خادمك، ولا تضعها أبدًا في شيفرة المتصفح.
- أرسل الطلب. اقرأ الإجابة من
choices[0].message.content.
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 لاستخدامها عند التواصل مع الدعم.
- 01تطبيقكالمفتاح محفوظ في متغير بيئة
- 02OpenAI SDKيتغيّر إعدادان فقط
base_urlapi_key - 03BroadNet Inferenceواجهة متوافقة مع OpenAI
inference.broadnet.ai/v1POST /chat/completions - 04النموذج الذي تحددهيُحدَّد في كل طلب
broadnet/deepseek-v4.1-flashbroadnet/glm-5.3broadnet/qwen3.8-27bbroadnet/gemma-4-26b-a4bاختيارك
- 05الاستجابةمن ذلك النموذج
أنت تختار النموذج في كل طلب. لا يوجد توجيه تلقائي: يُنفَّذ الطلب على معرّف النموذج الذي أرسلته.
يستدعي تطبيقك حزمة OpenAI SDK بعنوان URL الأساسي لـ BroadNet ومفتاحك. يذهب الطلب إلى BroadNet Inference مع معرّف النموذج الذي كتبته، وذلك النموذج هو الذي يجيب. لا شيء يختار النموذج أو يبدّله نيابةً عنك.
البث المتدفق
اضبط stream=true واقرأ أحداث Server-Sent Events حتى data: [DONE]. ومع stream_options.include_usage يصل استهلاك الرموز في آخر جزء. إذا انتهى البث قبل [DONE]، فاعتبر الإجابة غير مكتملة. تطلب BroadNet التحقق من البث المتدفق لكل نموذج قبل الاعتماد عليه في الإنتاج.
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. النموذج العربي أم متعدد اللغات، وتكلفة الصوت.
ما معرّفات النماذج التي يمكنني استخدامها؟
مرّر المعرّف الدقيق في model. لا تعتمد على /v1/models لاكتشاف نماذج المحادثة؛ استخدم هذه القائمة أو المرجع التقني (بالإنجليزية).
| النموذج | المعرّف | نقطة النهاية | المدخلات | الموثّق | الوصول |
|---|---|---|---|---|---|
| DeepSeek V4.1 Flash | broadnet/deepseek-v4.1-flash | /chat/completions | نص + صورة | الاستدلال المنطقي | يتطلب شحن الرصيد |
| GLM 5.3 | broadnet/glm-5.3 | /chat/completions | نص | الأدوات، المخرجات المنظَّمة، الاستدلال المنطقي | يتطلب شحن الرصيد |
| Qwen3.8 27B | broadnet/qwen3.8-27b | /chat/completions | نص + صورة | الأدوات، المخرجات المنظَّمة، الاستدلال المنطقي | يتطلب شحن الرصيد |
| BroadNet Gemma 4 VL 26B | broadnet/gemma-4-26b-a4b | /chat/completions | نص + صورة | — | الرصيد المبدئي |
| BroadNet Transcribe Arabic | broadnet/cohere-transcribe-arabic | /audio/transcriptions | صوت عربي | — | الرصيد المبدئي |
| BroadNet Transcribe | broadnet/cohere-transcribe | /audio/transcriptions | صوت، 14 لغةً | — | الرصيد المبدئي |
يسرد عمود «الموثّق» الأدوات والمخرجات المنظَّمة والاستدلال المنطقي التي يذكرها مرجع BroadNet لكل نموذج (تاريخ المراجعة: 2026-11-15). وتعني الشَّرطة أن المرجع لا يذكرها، لا أنها غير متوفرة.
الانتقال من واجهة أخرى متوافقة مع OpenAI: قائمة تحقق
صيغ الطلبات مألوفة، لكن النماذج تختلف. راجع كل بند للنموذج الذي اخترته، واختبر قبل تحويل حركة الطلبات.
- نقطة النهاية. اضبط عنوان URL الأساسي على
https://inference.broadnet.ai/v1. - المفتاح. استخدم مفتاح استدلال من BroadNet محفوظًا في متغير بيئة. مفاتيح الخطط منفصلة عن مفاتيح الدفع حسب الاستخدام.
- معرّف النموذج. استخدم المعرّف الدقيق، مثل
broadnet/gemma-4-26b-a4b. - المعاملات. تأكد من أن كل معامل ترسله موثّق لذلك النموذج، واحذف ما لا يرد في توثيقه.
- البث المتدفق. تأكد من أن عميلك يقرأ SSE حتى
[DONE]ويتعامل مع البث الذي ينتهي مبكرًا. - الأدوات والمخرجات المنظَّمة. يوثّق المرجع هذه الميزات لـ GLM 5.3 وQwen3.8 27B. اختبر أي نموذج آخر قبل الاعتماد عليها.
- الاستدلال المنطقي. قد يستهلك الاستدلال المنطقي جزءًا من ميزانية الإخراج. اترك هامشًا في
max_tokens؛ راجع الإجابات الفارغة من نماذج الاستدلال. - الحدود. يسمح مفتاح الدفع حسب الاستخدام بـ 30 طلبًا في الدقيقة و4 طلبات قيد التنفيذ في آنٍ واحد. وتسمح جلسة الخطة بطلب واحد في كل مرة. ويسمح مفتاح Gemma بالساعة بتدفق واحد و120 طلبًا في الدقيقة و300,000 رمز في الدقيقة.
- السياق. يشمل السياق المدخلات والإجابة معًا. راجع حد النموذج في صفحة النموذج.
- الأخطاء. اربط رموز الحالة أدناه بإجراء إعادة المحاولة أو الإصلاح المناسب، وسجّل
X-Request-ID. - التكاليف. قدّر التكلفة باستخدام حاسبات الأسعار. تُحتسب الصور ضمن رموز الإدخال في الدفع حسب الاستخدام.
ما الأخطاء التي يجب إعادة المحاولة عندها؟
| الحالة | المعنى | الإجراء |
|---|---|---|
| 400 / 422 | طلب أو حقل غير صالح | أصلح الطلب؛ ولا تُعِد إرساله كما هو |
| 401 | مفتاح مفقود أو غير صالح أو منتهي الصلاحية، أو حصة مستنفدة | تحقّق من المفتاح والحساب |
| 402 | insufficient_balance | اشحن الرصيد، ثم أعد المحاولة |
| 413 | الطلب يتجاوز حد البايتات أو النص | أرسل حجمًا أقل، كملف صوتي أصغر |
| 429 | حد المعدل أو التزامن أو معدل الرموز أو الإنفاق | انتظر مدة متزايدة لها حد أقصى، ثم أعد المحاولة |
| 500–504 | مشكلة من جهة الخادم | أعد المحاولة مع تراجع أُسّي محدود |
ملخّص من جدول الأخطاء في المرجع التقني (بالإنجليزية)، تاريخ المراجعة 2026-11-15. أمثلة شيفرة لإعادة المحاولة.
أين أجد المراجع والأدلة الكاملة؟

- المرجع التقني للمطوّرين (بالإنجليزية)صيغ الطلبات والحدود والأخطاء وملف الأسعار. المصدر المعتمد.
- التكاملات (بالإنجليزية)إعدادات Aider وCline وLangChain وn8n وLiteLLM وغيرها من الأدوات المتوافقة مع OpenAI.
- الأدلةحزم SDK والبث المتدفق وإعادة المحاولة وقوائم عناوين IP المسموح بها والكلام العربي.
- دليل Python SDKالتثبيت وأول طلب والبث المتدفق باستخدام OpenAI Python SDK.
- دليل Node SDKالخطوات نفسها بلغتي JavaScript وTypeScript، مع معرّفات الطلبات.
- بدء سريع مع cURLكل الطلبات من سطر الأوامر.
- المفاتيح وقوائم IP المسموح بهااقصر استخدام المفاتيح على خوادمك.
- منشئ طلبات API (بالإنجليزية)أنشئ طلبًا في متصفحك وانسخه.
هل تحتاج إلى نقطة نهاية خاصة أو نموذج غير مدرج؟ تواصل مع BroadNet.