تنقلك هذه الصفحة من مفتاح جديد إلى ثلاثة استدعاءات تعمل: إكمال محادثة، وإجابة ببث متدفق، وتفريغ صوتي. كل ما تحتاجه هو 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 ...) عند الإبلاغ عن مشكلة.
