BroadRouter
ابدأ الآن

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

آخر تحديث

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

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

  1. سجّل الدخول على inference.broadnet.ai (بالإنجليزية) وأنشئ مفتاح استدلال. يظهر المفتاح مرة واحدة فقط، ولا تحفظ لوحة التحكم سوى بصمته (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)

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

كيف يصل الطلب إلى النموذج
  1. 01تطبيقكالمفتاح محفوظ في متغير بيئة
  2. 02OpenAI SDKيتغيّر إعدادان فقط

    base_url api_key

  3. 03BroadNet Inferenceواجهة متوافقة مع OpenAIinference.broadnet.ai/v1POST /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)

الاستجابة بصيغة JSON، والنص المفرّغ في الحقل text. النموذج العربي أم متعدد اللغات، وتكلفة الصوت.

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

مرّر المعرّف الدقيق في model. لا تعتمد على /v1/models لاكتشاف نماذج المحادثة؛ استخدم هذه القائمة أو المرجع التقني (بالإنجليزية).

النموذجالمعرّفنقطة النهايةالمدخلاتالموثّقالوصول
DeepSeek V4.1 Flashbroadnet/deepseek-v4.1-flash/chat/completionsنص + صورةالاستدلال المنطقييتطلب شحن الرصيد
GLM 5.3broadnet/glm-5.3/chat/completionsنصالأدوات، المخرجات المنظَّمة، الاستدلال المنطقييتطلب شحن الرصيد
Qwen3.8 27Bbroadnet/qwen3.8-27b/chat/completionsنص + صورةالأدوات، المخرجات المنظَّمة، الاستدلال المنطقييتطلب شحن الرصيد
BroadNet Gemma 4 VL 26Bbroadnet/gemma-4-26b-a4b/chat/completionsنص + صورة—الرصيد المبدئي
BroadNet Transcribe Arabicbroadnet/cohere-transcribe-arabic/audio/transcriptionsصوت عربي—الرصيد المبدئي
BroadNet Transcribebroadnet/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؛ راجع الإجابات الفارغة من نماذج الاستدلال.
  8. الحدود. يسمح مفتاح الدفع حسب الاستخدام بـ 30 طلبًا في الدقيقة و4 طلبات قيد التنفيذ في آنٍ واحد. وتسمح جلسة الخطة بطلب واحد في كل مرة. ويسمح مفتاح Gemma بالساعة بتدفق واحد و120 طلبًا في الدقيقة و300,000 رمز في الدقيقة.
  9. السياق. يشمل السياق المدخلات والإجابة معًا. راجع حد النموذج في صفحة النموذج.
  10. الأخطاء. اربط رموز الحالة أدناه بإجراء إعادة المحاولة أو الإصلاح المناسب، وسجّل X-Request-ID.
  11. التكاليف. قدّر التكلفة باستخدام حاسبات الأسعار. تُحتسب الصور ضمن رموز الإدخال في الدفع حسب الاستخدام.

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

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

ملخّص من جدول الأخطاء في المرجع التقني (بالإنجليزية)، تاريخ المراجعة 2026-11-15. أمثلة شيفرة لإعادة المحاولة.

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

هل تحتاج إلى نقطة نهاية خاصة أو نموذج غير مدرج؟ تواصل مع BroadNet.

اقرأها بصيغة Markdownاسأل ChatGPTاسأل Claudeاسأل Perplexity