---
title: "LLM API curl کوئک اسٹارٹ: چیٹ، اسٹریمنگ، ٹرانسکرپشن | BroadRouter"
description: "curl سے BroadNet Inference کی پہلی کالز کریں: ایک chat completion، ایک اسٹریم شدہ جواب اور ایک آڈیو ٹرانسکرپشن، پھر ریسپانس، usage اور ایررز پڑھنا سیکھیں۔"
url: https://broadrouter.com/ur/guides/curl-quickstart/
lang: ur
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

یہ صفحہ انگریزی سے AI کی مدد سے ترجمہ کیا گیا ہے۔ [انگریزی اصل پڑھیں](https://broadrouter.com/guides/curl-quickstart/) (اپ ڈیٹ: 2026-11-16).

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

اپ ڈیٹ 2026-11-16

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](https://broadrouter.com/ur/guides/openai-python-sdk/) یا ٹول بھی چلے گا۔

## 1\. اپنی کلید سیٹ کریں

BroadNet کنسول میں ایک کلید بنائیں۔ نئے اکاؤنٹس کو $5 کا ابتدائی کریڈٹ ملتا ہے۔

```bash
export BROADNET_API_KEY='paste-your-key'
```

کلید صرف `Authorization: Bearer` ہیڈر میں بھیجیں۔

## 2\. آپ کا پہلا chat completion

BroadNet Gemma 4 VL 26B واحد چیٹ ماڈل ہے جو ابتدائی کریڈٹ پر چلتا ہے، اس لیے آغاز اسی سے کریں:

```bash
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` میں شمار ہوتی ہے:

```bash
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` ہے تو بجٹ ریزننگ کے دوران ہی ختم ہو گیا۔ دیکھیں [ریزننگ ماڈلز خالی جواب کیوں دیتے ہیں](https://broadrouter.com/ur/guides/reasoning-tokens-empty-response/)۔

## 4\. جواب اسٹریم کریں

`"stream": true` شامل کریں اور `-N` سے curl کی بفرنگ بند کریں:

```bash
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 کی اسٹریمنگ](https://broadrouter.com/ur/guides/streaming-chat-completions/) میں ہے۔

## 5\. آڈیو ٹرانسکرائب کریں

ٹرانسکرپشن multipart فارم لیتی ہے۔ 26,214,400 بائٹس تک کی WAV یا MP3 فائل بھیجیں، اور `language` ہمیشہ بھیجیں:

```bash
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 وائس نوٹس کیسے ٹرانسکرائب کریں](https://broadrouter.com/ur/guides/transcribe-whatsapp-voice-notes/)۔ عربی کے لیے `language=ar` کے ساتھ `broadnet/cohere-transcribe-arabic` استعمال کریں؛ دیکھیں [عربی اسپیچ ٹو ٹیکسٹ گائیڈ](https://broadrouter.com/ur/guides/arabic-speech-to-text-api/)۔ کثیر لسانی ماڈل کی قیمت $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` | ہاں |

فی ٹوکن اور فی منٹ قیمتیں [قیمتوں کے صفحے](https://broadrouter.com/ur/pricing/) پر ہیں۔ ہر ماڈل کا اپنا صفحہ ہے، مثلاً [GLM 5.3](https://broadrouter.com/ur/models/glm-5.3/)۔

## مسائل کا حل

-   **401۔** کلید موجود نہیں، غلط ہے یا اس کی میعاد ختم ہو چکی ہے، یا استعمال کے مطابق ادائیگی والی حد پوری ہو گئی ہے۔ دیکھیں کہ کلید کے آس پاس فالتو اسپیس تو نہیں۔
-   **model فیلڈ پر ایرر۔** ID ٹیبل سے کاپی کریں؛ اس میں `broadnet/` پریفکس شامل ہے۔ پیڈ ماڈلز ابتدائی کریڈٹ پر تب تک ناکام ہوتے ہیں جب تک آپ ٹاپ اپ نہ کریں۔
-   **413۔** آڈیو فائل 26,214,400 بائٹس سے بڑی ہے۔ اسے حصوں میں تقسیم کریں۔
-   **403۔** کلید کی IP allow-list، ماڈل پالیسی یا روٹ پالیسی نے درخواست رد کر دی۔ دیکھیں [API کلیدوں کے لیے IP allow-list](https://broadrouter.com/ur/guides/api-keys-ip-allow-lists/)۔
-   **429۔** استعمال کے مطابق ادائیگی والی کلید فی منٹ 30 درخواستوں اور بیک وقت 4 جاری درخواستوں کی اجازت دیتی ہے۔ رک کر دوبارہ کوشش کریں۔ دیکھیں [BroadNet کے ایرر کوڈز اور دوبارہ کوشش](https://broadrouter.com/ur/guides/errors-and-retries/)۔
-   **لامحدود پلان پر۔** ہر [پلان سیشن](https://broadrouter.com/ur/guides/unlimited-llm-api-sessions/) ایک وقت میں ایک ہی درخواست چلاتا ہے، اس لیے متوازی curl لوپس الگ الگ سیشنز پر چلائیں۔ پلان کی کلیدیں صرف `broadnet/deepseek-v4.1-flash` کے ساتھ کام کرتی ہیں۔

کوئی مسئلہ رپورٹ کرتے وقت `X-Request-ID` ریسپانس ہیڈر (`curl -D headers.txt ...`) محفوظ رکھیں۔

## اس گائیڈ کی اصطلاحات

[استعمال کے مطابق ادائیگی (pay-as-you-go)](https://broadrouter.com/ur/glossary/pay-as-you-go/)

استعمال کے مطابق ادائیگی (pay-as-you-go) قیمت طے کرنے کا ایک ماڈل ہے جس میں آپ صرف اتنا دیتے ہیں جتنا استعمال کرتے ہیں، ٹوکن، درخواستوں یا آڈیو منٹ جیسی اکائیوں میں ناپ کر، بغیر سبسکرپشن یا کم از کم وابستگی کے۔ زیادہ تر LLM API اسی طرح بل بناتے ہیں، پری پیڈ بیلنس یا وقتاً فوقتاً بننے والی انوائس سے۔

[ٹوکن (token)](https://broadrouter.com/ur/glossary/token/)

ٹوکن متن کی وہ اکائی ہے جسے لینگویج ماڈل پڑھتا اور لکھتا ہے: کوئی لفظ، لفظ کا حصہ، رموزِ اوقاف کی کوئی علامت یا بائٹس کا سلسلہ، جو ماڈل کا ٹوکنائزر بناتا ہے۔ LLM API استعمال کو ٹوکنز میں گنتے ہیں، انہی میں حدیں لگاتے ہیں اور عموماً بل بھی بناتے ہیں۔

[پری پیڈ کریڈٹ (prepaid credit)](https://broadrouter.com/ur/glossary/prepaid-credit/)

پری پیڈ کریڈٹ وہ رقم ہے جو استعمال سے پہلے API اکاؤنٹ میں ڈالی جاتی ہے۔ ہر درخواست کی لاگت بیلنس سے کٹتی ہے، اور بیلنس ختم ہونے پر میٹر والی درخواستیں تب تک رک جاتی ہیں جب تک آپ ٹاپ اپ نہ کریں۔ اس سے خرچ اتنا ہی رہتا ہے جتنا آپ نے جمع کیا ہے۔

[کنکرنسی (concurrency)](https://broadrouter.com/ur/glossary/concurrency/)

کنکرنسی، کسی کلائنٹ کی بیک وقت چل رہی (in-flight) درخواستوں کی تعداد ہے۔ LLM APIs اکثر اس کی حد ہر کلید یا پلان پر، فی منٹ درخواستوں سے الگ رکھتے ہیں، کیونکہ ہر کھلی درخواست جواب مکمل ہونے تک GPU کی گنجائش گھیرے رکھتی ہے۔

[اسپیچ ٹو ٹیکسٹ (speech-to-text)](https://broadrouter.com/ur/glossary/speech-to-text/)

اسپیچ ٹو ٹیکسٹ، جسے automatic speech recognition (ASR) بھی کہتے ہیں، بولے گئے آڈیو کو تحریری متن میں بدلنے کی ٹیکنالوجی ہے۔ speech-to-text API آڈیو فائل یا اسٹریم لے کر ٹرانسکرپٹ لوٹاتا ہے، عموماً فی آڈیو منٹ قیمت پر۔ درستگی ورڈ ایرر ریٹ سے ناپی جاتی ہے اور لہجے، بولی اور ریکارڈنگ کے معیار کے ساتھ بدلتی ہے۔

[اسٹریمنگ (streaming)](https://broadrouter.com/ur/glossary/streaming/)

اسٹریمنگ، لینگویج ماڈل کے جواب کو آخر میں ایک ساتھ لوٹانے کے بجائے، بنتے وقت ہی چھوٹے چھوٹے ٹکڑوں (chunks) میں لوٹانے کا طریقہ ہے۔ OpenAI-compatible APIs، درخواست میں stream کو true سیٹ کرنے پر server-sent events کے ذریعے اسٹریم کرتے ہیں۔

[ریٹ لمٹ (rate limit)](https://broadrouter.com/ur/glossary/rate-limit/)

ریٹ لمٹ وہ حد ہے جو کوئی API طے کرتا ہے کہ ایک کلائنٹ کسی مدت میں اسے کتنا استعمال کر سکتا ہے، جیسے فی منٹ درخواستیں یا فی منٹ ٹوکن۔ حد سے زیادہ درخواستیں رد کر دی جاتی ہیں، عموماً HTTP 429 Too Many Requests کے ساتھ، جب تک استعمال دوبارہ حد سے نیچے نہ آ جائے۔

[Chat Completions API](https://broadrouter.com/ur/glossary/chat-completions-api/)

Chat Completions API، OpenAI کا HTTP اینڈپوائنٹ POST /v1/chat/completions ہے، جو ایک ماڈل کا نام اور رول والے پیغامات کی فہرست لیتا ہے اور ماڈل کا اگلا پیغام لوٹاتا ہے۔ اس کی درخواست اور جواب کی ساخت وہ عام فارمیٹ بن گئی جسے OpenAI-compatible فراہم کنندگان اور SDKs اپناتے ہیں۔

## عام سوالات

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

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 استعمال کریں۔

## متعلقہ گائیڈز

-   [BroadNet Inference کے ساتھ OpenAI Python SDK استعمال کریں](https://broadrouter.com/ur/guides/openai-python-sdk/)
-   [chat completions اسٹریم کریں اور ٹوٹے کنکشن سنبھالیں](https://broadrouter.com/ur/guides/streaming-chat-completions/)
-   [عربی speech-to-text API، قدم بہ قدم](https://broadrouter.com/ur/guides/arabic-speech-to-text-api/)
-   [BroadNet Inference کے ایرر کوڈز اور دوبارہ کوشش کب کریں](https://broadrouter.com/ur/guides/errors-and-retries/)

اسے اپنے اصل کام پر آزمائیں۔ نئے اکاؤنٹس Gemma اور ٹرانسکرپشن کے لیے US$5 کے کریڈٹ سے شروع ہوتے ہیں۔ DeepSeek، GLM، اور Qwen3.8 کے لیے ٹاپ اپ ضروری ہے۔

[شروع کریں](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ur-guides-curl-quickstart&utm_content=page-cta) ·

**ذرائع**

-   [BroadNet Inference API ریفرنس (انگریزی میں)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ur-guides-curl-quickstart&utm_content=sources)
-   [مشین سے پڑھی جانے والی ماڈلز کی فہرست اور قیمتیں (pricing.json) (انگریزی میں)](https://inference.broadnet.ai/pricing.json?utm_source=broadrouter&utm_medium=referral&utm_campaign=ur-guides-curl-quickstart&utm_content=sources)
