---
title: "Vercel AI SDK: کسٹم base URL کے ساتھ createOpenAICompatible"
description: "@ai-sdk/openai-compatible کے createOpenAICompatible سے Vercel AI SDK میں BroadNet Inference کال کریں: generateText، streamText، ٹولز اور reasoning effort۔"
url: https://broadrouter.com/ur/guides/vercel-ai-sdk-openai-compatible/
lang: ur
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# BroadNet Inference کے ساتھ Vercel AI SDK استعمال کریں

اپ ڈیٹ 2026-11-16

ai اور @ai-sdk/openai-compatible انسٹال کریں، پھر createOpenAICompatible کو name میں broadnet، baseURL میں https://inference.broadnet.ai/v1 اور apiKey میں اپنی BroadNet کلید کے ساتھ کال کریں۔ فراہم کنندہ کو broadnet/glm-5.3 جیسا BroadNet ماڈل ID دیں اور generateText یا streamText معمول کے مطابق استعمال کریں۔ کلید سرور پر رکھیں، اور ریزننگ ماڈلز کو کھلا maxOutputTokens دیں۔

Vercel کا [AI SDK](https://ai-sdk.dev/providers/openai-compatible-providers) LLM ایپس بنانے کے لیے ایک TypeScript ٹول کٹ ہے۔ اس کا `@ai-sdk/openai-compatible` پیکج OpenAI chat-completions فارمیٹ پر چلنے والے کسی بھی API کے لیے فراہم کنندہ بناتا ہے۔ BroadNet Inference اسی فارمیٹ پر چلتا ہے، اس لیے آپ کو صرف base URL، کلید اور ماڈل IDs بدلنے ہیں۔ اگر آپ سادہ OpenAI کلائنٹ استعمال کرنا چاہتے ہیں تو [Node SDK گائیڈ](https://broadrouter.com/ur/guides/openai-node-sdk/) دیکھیں۔

## سیٹ اپ

1.  **پیکجز انسٹال کریں۔** یہ لکھتے وقت npm پر `ai` 7.x اور `@ai-sdk/openai-compatible` 3.x دستیاب ہیں۔
    
    ```bash
    npm install ai @ai-sdk/openai-compatible
    export BROADNET_API_KEY='your-broadnet-key'
    ```
    
2.  **فراہم کنندہ بنائیں۔** نیچے `includeUsage` والے تبصرے کا مطلب ہے کہ اسٹریمنگ رسپانسز میں usage ڈیٹا آئے گا۔
    
    ```ts
    // broadnet.ts
    import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
    
    export const broadnet = createOpenAICompatible({
      name: 'broadnet',
      baseURL: 'https://inference.broadnet.ai/v1',
      apiKey: process.env.BROADNET_API_KEY,
      includeUsage: true, // usage data in streaming responses
    });
    ```
    
3.  **متن بنائیں۔** `maxOutputTokens` والا تبصرہ یاد دلاتا ہے کہ ریزننگ بھی اسی حد میں گنی جاتی ہے۔
    
    ```ts
    import { generateText } from 'ai';
    import { broadnet } from './broadnet';
    
    const { text, usage, finishReason } = await generateText({
      model: broadnet('broadnet/glm-5.3'),
      prompt: 'Explain idempotency keys in two sentences.',
      maxOutputTokens: 4000, // reasoning counts toward this
    });
    
    console.log(text, finishReason, usage);
    ```
    
4.  **اسٹریم کریں۔** `generateText` کی جگہ `streamText` لگائیں اور `textStream` پڑھیں۔ اس کے نیچے کا وائر فارمیٹ [اسٹریمنگ گائیڈ](https://broadrouter.com/ur/guides/streaming-chat-completions/) میں سمجھایا گیا ہے۔
    

آپ جو `name` دیتے ہیں وہی فراہم کنندہ کے آپشنز اور میٹا ڈیٹا کی کلید بن جاتا ہے، اس لیے اسے مختصر اور مستقل رکھیں۔ `provider('id')` اور `provider.chatModel('id')` دونوں چیٹ ماڈل بناتے ہیں؛ ہر ماڈل کے لیے الگ سیٹ اپ نہیں۔ کلید سرور پر رکھیں۔ اس فائل کو براؤزر میں چلنے والے کوڈ میں import نہ کریں، ورنہ کلید ہر وزیٹر تک پہنچ جائے گی۔

فراہم کنندہ کی دستاویزات متن بنانے، اسٹریمنگ، ٹول کالنگ، اسٹرکچرڈ آؤٹ پٹ، ریزننگ مواد اور تصویری ان پٹ کو سپورٹ شدہ صلاحیتیں بتاتی ہیں، اس نوٹ کے ساتھ کہ ان میں سے کچھ فراہم کنندہ پر منحصر ہیں۔ BroadNet پر تصویری ان پٹ DeepSeek V4.1 Flash، Qwen3.8 27B اور Gemma 4 VL 26B کے ساتھ چلتا ہے۔ GLM 5.3 صرف متن لیتا ہے۔

## سیٹ کرنے کے قابل آپشنز

-   **reasoningEffort۔** اسے `providerOptions` کے ذریعے، فراہم کنندہ کے نام کی کلید کے نیچے پاس کریں۔ AI SDK کی دستاویزات کہتی ہیں کہ درست قدریں فراہم کنندہ پر منحصر ہیں؛ BroadNet کی دستاویزات `low` دکھاتی ہیں۔

```ts
const result = await generateText({
  model: broadnet('broadnet/deepseek-v4.1-flash'),
  prompt: 'Classify: "refund my order" -> intent?',
  providerOptions: { broadnet: { reasoningEffort: 'low' } },
});
```

-   **supportsStructuredOutputs۔** AI SDK، JSON schemas صرف تب بھیجتا ہے جب فراہم کنندہ پر یہ `true` ہو۔ BroadNet، اسٹرکچرڈ آؤٹ پٹ GLM 5.3 اور Qwen3.8 27B کے لیے درج کرتا ہے۔ اسے آن کریں تو schema والے آؤٹ پٹ کے لیے یہی ماڈلز استعمال کریں۔
-   **maxRetries۔** `generateText` بطورِ ڈیفالٹ دو بار دوبارہ کوشش کرتا ہے۔ اسے اپنی ریٹ لمٹ کے حساب سے سیٹ کریں۔
-   **ریزننگ آؤٹ پٹ۔** فراہم کنندہ ریزننگ مواد لوٹائے تو AI SDK اسے پڑھتا ہے۔ ٹاپ لیول `reasoningText` نتیجہ فیلڈ اب deprecated ہے اور اس کی جگہ `finalStep.reasoningText` ہے۔ ایسی لاجک نہ بنائیں جو ریزننگ کی موجودگی پر منحصر ہو۔

## کون سا ماڈل چنیں

| ضرورت | ماڈل | کانٹیکسٹ |
| --- | --- | --- |
| ٹول کالنگ، اسٹرکچرڈ آؤٹ پٹ | [`broadnet/glm-5.3`](https://broadrouter.com/ur/models/glm-5.3/) | 1,048,576 |
| تصاویر کے ساتھ ٹولز، عربی | [`broadnet/qwen3.8-27b`](https://broadrouter.com/ur/models/qwen3.8-27b/) | 262,144 |
| لمبا کانٹیکسٹ، مقررہ قیمت والا پلان | [`broadnet/deepseek-v4.1-flash`](https://broadrouter.com/ur/models/deepseek-v4.1-flash/) | 1,048,576 |
| سستی متن اور تصویر کالز | [`broadnet/gemma-4-26b-a4b`](https://broadrouter.com/ur/models/gemma-4-vl-26b/) | 32,768 |

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

## مسائل کا حل

-   **401۔** رن ٹائم میں `BROADNET_API_KEY` موجود نہیں (اپنے ہوسٹنگ فراہم کنندہ کی env سیٹنگز دیکھیں)، یا کلید غلط ہے، اس کی میعاد ختم ہو گئی ہے، یا استعمال کے مطابق ادائیگی والا الاؤنس ختم ہو گیا ہے۔
-   **providerOptions نظر انداز ہوتے ہیں۔** کلید، فراہم کنندہ کے `name` سے camelCase میں ملنی چاہیے۔ `name: 'broadnet'` کے ساتھ `providerOptions.broadnet` استعمال کریں۔
-   **ماڈل ایررز۔** ID، `broadnet/` پری فکس سمیت، BroadNet کے ID سے بالکل ملنا چاہیے۔ GLM 5.3، Qwen3.8 27B اور DeepSeek V4.1 Flash کے لیے ٹاپ اپ چاہیے؛ $5 ابتدائی کریڈٹ Gemma 4 VL 26B اور دو Transcribe ماڈلز کا احاطہ کرتا ہے۔
-   **خالی متن، finishReason “length”۔** ریزننگ نے بجٹ خرچ کر دیا۔ `maxOutputTokens` بڑھائیں یا `reasoningEffort` کم کریں۔ [جوابات خالی کیوں آتے ہیں](https://broadrouter.com/ur/guides/reasoning-tokens-empty-response/)۔
-   **لوڈ کے وقت 429۔** استعمال کے مطابق ادائیگی والی کلید فی منٹ 30 درخواستوں اور بیک وقت 4 جاری درخواستوں کی اجازت دیتی ہے۔ سرور لیس فنکشنز تیزی سے پھیلتے ہیں، اس لیے اپنی ایپ میں concurrency کی حد رکھیں۔ [ایررز اور دوبارہ کوشش](https://broadrouter.com/ur/guides/errors-and-retries/) دیکھیں۔
-   **پلان کلید پر متوازی ایجنٹس۔** ایک [لامحدود پلان سیشن](https://broadrouter.com/ur/guides/unlimited-llm-api-sessions/) ایک وقت میں ایک درخواست چلاتا ہے۔ کئی ایجنٹس پر `Promise.all` چلانے کے لیے ہر ایجنٹ کو اپنا سیشن چاہیے، ورنہ درخواستیں قطار میں لگتی ہیں۔

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

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

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

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

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

[اسٹرکچرڈ آؤٹ پٹ (structured output)](https://broadrouter.com/ur/glossary/structured-output/)

اسٹرکچرڈ آؤٹ پٹ LLM API کا ایک فیچر ہے جو ماڈل کے جواب کو ڈویلپر کے طے کردہ فارمیٹ، عموماً JSON Schema، تک محدود کرتا ہے، تاکہ کوڈ اسے قابلِ اعتماد طریقے سے پارس کر سکے۔ یہ JSON mode سے زیادہ سخت ہے، جو درست JSON کی ضمانت دیتا ہے، لیکن کسی خاص ساخت کی نہیں۔

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

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

[ٹول کالنگ (tool calling)](https://broadrouter.com/ur/glossary/tool-calling/)

ٹول کالنگ، جسے function calling بھی کہتے ہیں، LLM API کی وہ سہولت ہے جس میں ماڈل ڈویلپر کے طے کردہ کسی فنکشن کو چلانے کی ایک منظم درخواست، JSON آرگیومنٹس کے ساتھ، لوٹاتا ہے۔ ایپلیکیشن فنکشن چلا کر نتیجہ واپس بھیجتی ہے؛ ماڈل خود کبھی کوڈ نہیں چلاتا۔

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

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

[base URL](https://broadrouter.com/ur/glossary/base-url/)

base URL کسی API کا مقررہ بنیادی پتہ ہے، جیسے https://api.example.com/v1، جسے کلائنٹ /chat/completions جیسے ہر اینڈپوائنٹ پاتھ کے آگے لگاتا ہے۔ OpenAI-compatible SDK میں base URL کو API کلید اور ماڈل ID کے ساتھ بدلنے سے وہی کوڈ کسی دوسرے فراہم کنندہ سے جڑ جاتا ہے۔

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

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

## عام سوالات

### @ai-sdk/openai استعمال کروں یا @ai-sdk/openai-compatible؟

تھرڈ پارٹی OpenAI-compatible APIs کے لیے @ai-sdk/openai-compatible استعمال کریں۔ یہ chat completions اینڈپوائنٹ کال کرتا ہے، اور BroadNet Inference یہی فراہم کرتا ہے۔

### بنایا گیا متن خالی کیوں ہے؟

BroadNet پر ریزننگ، max\_tokens میں گنی جاتی ہے۔ اگر maxOutputTokens چھوٹا ہو تو ماڈل جواب شروع ہونے سے پہلے ہی اسے پورا خرچ کر سکتا ہے۔ اسے بڑھائیں یا reasoningEffort کو low پر سیٹ کریں۔

### اسٹریمنگ کے دوران ٹوکن usage کیسے ملے؟

فراہم کنندہ بناتے وقت includeUsage کو true پر سیٹ کریں۔ AI SDK کی دستاویزات کہتی ہیں کہ اس سے اسٹریمنگ رسپانسز میں usage ڈیٹا شامل ہو جاتا ہے۔ اس کا ڈیفالٹ false ہے۔

### کیا ہر BroadNet ماڈل کے لیے الگ سیٹ اپ چاہیے؟

نہیں۔ ایک createOpenAICompatible فراہم کنندہ تمام ماڈلز کا احاطہ کرتا ہے۔ کسی بھی BroadNet چیٹ ماڈل ID کے ساتھ broadnet('model-id') یا broadnet.chatModel('model-id') کال کریں۔

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

-   [BroadNet Inference کے ساتھ OpenAI Node.js SDK استعمال کریں](https://broadrouter.com/ur/guides/openai-node-sdk/)
-   [chat completions اسٹریم کریں اور ٹوٹے کنکشن سنبھالیں](https://broadrouter.com/ur/guides/streaming-chat-completions/)
-   [ریزننگ ماڈل خالی جواب کیوں لوٹاتا ہے](https://broadrouter.com/ur/guides/reasoning-tokens-empty-response/)
-   [opencode میں BroadNet Inference کو کسٹم پرووائیڈر کے طور پر شامل کریں](https://broadrouter.com/ur/guides/opencode-custom-provider/)
-   [BroadNet Inference کے ساتھ کام کرنے والے تمام ٹولز (انگریزی میں)](https://broadrouter.com/integrations/): SDKs، کوڈنگ ایجنٹس، چیٹ انٹرفیس اور آٹومیشن ٹولز، ہر ایک کی درست سیٹنگز کے ساتھ

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

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

**ذرائع**

-   [AI SDK دستاویزات، OpenAI Compatible فراہم کنندگان (2026-11-14 کو جانچا گیا)](https://ai-sdk.dev/providers/openai-compatible-providers)
-   [AI SDK دستاویزات، generateText ریفرنس (2026-11-14 کو جانچا گیا)](https://ai-sdk.dev/docs/reference/ai-sdk-core/generate-text)
-   [npm، @ai-sdk/openai-compatible پیکج (3.x، 2026-11-14 کو جانچا گیا)](https://www.npmjs.com/package/@ai-sdk/openai-compatible)
-   [BroadNet Inference API ریفرنس (انگریزی میں)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ur-guides-vercel-ai-sdk-openai-compatible&utm_content=sources)
