BroadRouter
ابدأ الآن

أول طلب إلى BroadNet Inference باستخدام curl

آخر تحديث

أرسل طلب POST إلى https://inference.broadnet.ai/v1/chat/completions مع الترويسة Authorization Bearer ومفتاحك، وجسم JSON يحتوي على model، مثل broadnet/gemma-4-26b-a4b، وعلى messages. أضف stream true للبث المتدفق. أما الصوت فأرسل نموذج multipart يضم model وlanguage وfile إلى /v1/audio/transcriptions.

تنقلك هذه الصفحة من مفتاح جديد إلى ثلاثة استدعاءات تعمل: إكمال محادثة، وإجابة ببث متدفق، وتفريغ صوتي. كل ما تحتاجه هو curl. يستخدم BroadNet Inference صيغة طلبات OpenAI، فإذا نجحت هذه الاستدعاءات، فستعمل أيضًا أي حزمة SDK متوافقة مع OpenAI أو أي أداة متوافقة.

1. اضبط مفتاحك

أنشئ مفتاحًا في لوحة تحكم BroadNet. تحصل الحسابات الجديدة على رصيد مبدئي قدره $5.

export BROADNET_API_KEY='paste-your-key'

أرسل المفتاح في الترويسة Authorization: Bearer فقط.

2. أول إكمال محادثة

نموذج BroadNet Gemma 4 VL 26B هو نموذج المحادثة الوحيد الذي يعمل بالرصيد المبدئي، فابدأ به:

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": "Say hello in English and Arabic."}]
  }'

الرد بصيغة JSON القياسية لإكمال المحادثات. تجد الإجابة في choices[0].message.content، ويحتوي usage على أعداد الرموز (التوكنات) التي تدفع ثمنها.

3. جرّب نموذج استدلال منطقي

بعد شحن الرصيد، غيّر النموذج. تُجري نماذج GLM 5.3 وQwen3.8 27B وDeepSeek V4.1 Flash استدلالًا منطقيًا قبل أن تجيب، ويُحتسب هذا الاستدلال ضمن max_tokens:

curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "broadnet/glm-5.3",
    "max_tokens": 2000,
    "reasoning_effort": "low",
    "messages": [{"role": "user", "content": "Give me a regex for a UK postcode."}]
  }'

إذا كان content فارغًا وكانت قيمة finish_reason هي length، فقد نفدت الميزانية أثناء الاستدلال. راجع لماذا تُرجع نماذج الاستدلال المنطقي إجابات فارغة.

4. بثّ الرد

أضف "stream": true وأوقف التخزين المؤقت لمخرجات curl بالخيار -N:

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 to five."}]}'

تصلك أحداث Server-Sent Events. ينتهي البث بالسطر الحرفي data: [DONE]، ومع include_usage يحمل آخر جزء أعداد الرموز. التفاصيل في البث المتدفق لإكمال المحادثات.

5. حوّل الصوت إلى نص

يستقبل التفريغ الصوتي نموذج multipart. أرسل ملف WAV أو MP3 لا يتجاوز 26,214,400 بايت، وأرسل language دائمًا:

curl https://inference.broadnet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -F model=broadnet/cohere-transcribe \
  -F language=en \
  -F file=@meeting.mp3

الاستجابة بصيغة JSON والنص المفرّغ في text. تحتاج الملاحظات الصوتية من WhatsApp بصيغة .ogg والتسجيلات بصيغة .m4a إلى التحويل أولًا؛ راجع كيف تفرّغ ملاحظات WhatsApp الصوتية. وللعربية، استخدم broadnet/cohere-transcribe-arabic مع language=ar؛ راجع دليل تحويل الصوت العربي إلى نص. يكلّف النموذج متعدد اللغات $0.002 لكل دقيقة صوت، والنموذج العربي $0.0042.

أي نموذج تختار؟

النموذج المعرّف نقطة النهاية الرصيد المجاني
BroadNet Gemma 4 VL 26B broadnet/gemma-4-26b-a4b /v1/chat/completions نعم
GLM 5.3 broadnet/glm-5.3 /v1/chat/completions لا
Qwen3.8 27B broadnet/qwen3.8-27b /v1/chat/completions لا
DeepSeek V4.1 Flash broadnet/deepseek-v4.1-flash /v1/chat/completions لا
BroadNet Transcribe broadnet/cohere-transcribe /v1/audio/transcriptions نعم
BroadNet Transcribe Arabic broadnet/cohere-transcribe-arabic /v1/audio/transcriptions نعم

تجد الأسعار لكل رمز ولكل دقيقة في صفحة الأسعار. ولكل نموذج صفحة خاصة به، مثل GLM 5.3.

حل المشكلات

  • 401. المفتاح مفقود أو غير صالح أو منتهي الصلاحية، أو استُنفدت حصة الدفع حسب الاستخدام. تأكّد من عدم وجود مسافات زائدة حول المفتاح.
  • خطأ في الحقل model. انسخ المعرّف من الجدول؛ فهو يتضمّن البادئة broadnet/. وتفشل النماذج المدفوعة مع الرصيد المبدئي إلى أن تشحن رصيدك.
  • 413. حجم الملف الصوتي يتجاوز 26,214,400 بايت. قسّمه.
  • 403. رفضت قائمة عناوين IP المسموح بها للمفتاح، أو سياسة النموذج أو المسار، الطلبَ. راجع قوائم عناوين IP المسموح بها لمفاتيح API.
  • 429. يسمح مفتاح الدفع حسب الاستخدام بما يصل إلى 30 من الطلبات في الدقيقة و4 من الطلبات قيد التنفيذ في آنٍ واحد. انتظر مدة متزايدة ثم أعد المحاولة. راجع رموز أخطاء BroadNet وإعادة المحاولة.
  • على خطة غير محدودة. كل جلسة في الخطة تنفّذ طلبًا واحدًا في كل مرة، فشغّل حلقات curl المتوازية على جلسات منفصلة. ولا تعمل مفاتيح الخطط إلا مع broadnet/deepseek-v4.1-flash.

احفظ ترويسة الاستجابة X-Request-ID (curl -D headers.txt ...) عند الإبلاغ عن مشكلة.

أسئلة شائعة

أي نموذج يمكنني استدعاؤه بالرصيد المبدئي المجاني؟

نموذج BroadNet Gemma 4 VL 26B، بالمعرّف broadnet/gemma-4-26b-a4b، ونموذجا التفريغ الصوتي كلاهما. أما GLM 5.3 وQwen3.8 27B وDeepSeek V4.1 Flash فتتطلب شحن الرصيد.

لماذا يصل محتوى الرسالة فارغًا في استجابة curl؟

تُنفق نماذج الاستدلال المنطقي max_tokens على الاستدلال أولًا. إذا كانت قيمة finish_reason هي length، فارفع max_tokens إلى 1,000 أو أكثر.

لماذا يظهر النص العربي المفرّغ بحروف لاتينية؟

لم يتضمّن الطلب الحقل language. أرسل language=ar للعربية، ورمز ISO 639-1 المناسب للغات الأخرى.

هل يعرض GET /v1/models كل النماذج التي يمكنني استدعاؤها؟

تقول وثائق BroadNet إن GET /v1/models "supplies public catalogue metadata for external monitors" (الترجمة: «يوفّر بيانات وصفية عامة للكتالوج لأدوات المراقبة الخارجية»). استخدم في طلباتك معرّفات النماذج الواردة في المرجع التقني أو في pricing.json.

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