یہ صفحہ آپ کو نئی کلید سے تین چلتی ہوئی کالز تک لے جاتا ہے: ایک chat completion، ایک اسٹریم شدہ جواب اور ایک ٹرانسکرپشن۔ آپ کو صرف curl چاہیے۔ BroadNet Inference، OpenAI والی درخواست کی ساخت استعمال کرتا ہے، اس لیے یہ چل گئیں تو کوئی بھی OpenAI-compatible SDK یا ٹول بھی چلے گا۔
1. اپنی کلید سیٹ کریں
BroadNet کنسول میں ایک کلید بنائیں۔ نئے اکاؤنٹس کو $5 کا ابتدائی کریڈٹ ملتا ہے۔
export BROADNET_API_KEY='paste-your-key'
کلید صرف Authorization: Bearer ہیڈر میں بھیجیں۔
2. آپ کا پہلا chat completion
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."}]
}'
جواب عام chat-completions 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 شامل کریں اور -N سے curl کی بفرنگ بند کریں:
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 کے ساتھ آخری چنک میں ٹوکن گنتیاں آتی ہیں۔ مزید تفصیل chat completions کی اسٹریمنگ میں ہے۔
5. آڈیو ٹرانسکرائب کریں
ٹرانسکرپشن multipart فارم لیتی ہے۔ 26,214,400 بائٹس تک کی WAV یا MP3 فائل بھیجیں، اور 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 وائس نوٹس کیسے ٹرانسکرائب کریں۔ عربی کے لیے language=ar کے ساتھ broadnet/cohere-transcribe-arabic استعمال کریں؛ دیکھیں عربی اسپیچ ٹو ٹیکسٹ گائیڈ۔ کثیر لسانی ماڈل کی قیمت $0.002 فی آڈیو منٹ ہے اور عربی ماڈل کی $0.0042۔
کون سا ماڈل منتخب کریں
| ماڈل | ID | اینڈپوائنٹ | مفت کریڈٹ |
|---|---|---|---|
| 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 فیلڈ پر ایرر۔ ID ٹیبل سے کاپی کریں؛ اس میں
broadnet/پریفکس شامل ہے۔ پیڈ ماڈلز ابتدائی کریڈٹ پر تب تک ناکام ہوتے ہیں جب تک آپ ٹاپ اپ نہ کریں۔ - 413۔ آڈیو فائل 26,214,400 بائٹس سے بڑی ہے۔ اسے حصوں میں تقسیم کریں۔
- 403۔ کلید کی IP allow-list، ماڈل پالیسی یا روٹ پالیسی نے درخواست رد کر دی۔ دیکھیں API کلیدوں کے لیے IP allow-list۔
- 429۔ استعمال کے مطابق ادائیگی والی کلید فی منٹ 30 درخواستوں اور بیک وقت 4 جاری درخواستوں کی اجازت دیتی ہے۔ رک کر دوبارہ کوشش کریں۔ دیکھیں BroadNet کے ایرر کوڈز اور دوبارہ کوشش۔
- لامحدود پلان پر۔ ہر پلان سیشن ایک وقت میں ایک ہی درخواست چلاتا ہے، اس لیے متوازی curl لوپس الگ الگ سیشنز پر چلائیں۔ پلان کی کلیدیں صرف
broadnet/deepseek-v4.1-flashکے ساتھ کام کرتی ہیں۔
کوئی مسئلہ رپورٹ کرتے وقت X-Request-ID ریسپانس ہیڈر (curl -D headers.txt ...) محفوظ رکھیں۔
