BroadRouter
شروع کریں

curl کے ساتھ BroadNet Inference کو پہلی درخواست

اپ ڈیٹ

https://inference.broadnet.ai/v1/chat/completions پر POST بھیجیں، جس کے Authorization Bearer ہیڈر میں آپ کی کلید ہو اور JSON باڈی میں model (مثلاً broadnet/gemma-4-26b-a4b) اور messages ہوں۔ اسٹریمنگ کے لیے stream true شامل کریں۔ آڈیو کے لیے /v1/audio/transcriptions پر model، language اور file والا multipart فارم بھیجیں۔

یہ صفحہ آپ کو نئی کلید سے تین چلتی ہوئی کالز تک لے جاتا ہے: ایک 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 ...) محفوظ رکھیں۔

عام سوالات

مفت ابتدائی کریڈٹ پر میں کون سا ماڈل کال کر سکتا ہوں؟

BroadNet Gemma 4 VL 26B (ماڈل ID broadnet/gemma-4-26b-a4b) اور دونوں ٹرانسکرپشن ماڈلز۔ GLM 5.3، Qwen3.8 27B اور DeepSeek V4.1 Flash کے لیے ٹاپ اپ ضروری ہے۔

میرے curl ریسپانس میں message content خالی کیوں ہے؟

ریزننگ ماڈلز 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" (ترجمہ: بیرونی مانیٹرز کے لیے عوامی کیٹلاگ میٹا ڈیٹا فراہم کرتا ہے)۔ درخواستوں کے لیے API ریفرنس یا pricing.json میں دیے گئے ماڈل ID استعمال کریں۔

Markdown میں پڑھیںChatGPT سے پوچھیںClaude سے پوچھیںPerplexity سے پوچھیں