---
title: "Spring AI OpenAI اسٹارٹر، کسٹم base-url کے ساتھ | BroadRouter"
description: "Spring AI کے OpenAI چیٹ اسٹارٹر کو spring.ai.openai.base-url، BroadNet ماڈل ID اور max-tokens سے BroadNet Inference پر لگائیں، پھر ChatClient سے کال کریں۔"
url: https://broadrouter.com/ur/guides/spring-ai-openai-base-url/
lang: ur
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# Spring AI کو BroadNet Inference کے ساتھ چلائیں (OpenAI base-url)

اپ ڈیٹ 2026-11-16

spring-ai-starter-model-openai شامل کریں، پھر spring.ai.openai.base-url کو https://inference.broadnet.ai/v1، spring.ai.openai.api-key کو اپنی BroadNet کلید اور spring.ai.openai.chat.model کو broadnet/glm-5.3 جیسے BroadNet ID پر سیٹ کریں۔ spring.ai.openai.chat.max-tokens میں ریزننگ کے لیے جگہ رکھیں۔ Spring AI 2.x، openai-java SDK استعمال کرتا ہے، جو base URL کے بعد /chat/completions جوڑتا ہے۔

Spring AI، Java میں AI کے لیے Spring پروجیکٹ کا فریم ورک ہے۔ اس کا OpenAI چیٹ اسٹارٹر ایک `base-url` پڑھتا ہے، اس لیے یہ کسی بھی OpenAI-compatible سرور کو کال کر سکتا ہے۔ BroadNet Inference، `https://inference.broadnet.ai/v1` پر معیاری chat completions فراہم کرتا ہے۔ BroadRouter، BroadNet کی اپنی سائٹ ہے؛ یہ گائیڈ Spring AI 2.0.2 ریفرنس پر مبنی ہے۔

## اسٹارٹر شامل کریں

Spring AI BOM موجود ہونے پر (Spring AI کی dependency management دستاویزات دیکھیں):

```xml
<dependency>
  <groupId>org.springframework.ai</groupId>
  <artifactId>spring-ai-starter-model-openai</artifactId>
</dependency>
```

## کنفیگر کریں

`application.properties`:

```properties
spring.ai.openai.base-url=https://inference.broadnet.ai/v1
spring.ai.openai.api-key=${BROADNET_API_KEY}
spring.ai.openai.chat.model=broadnet/glm-5.3
spring.ai.openai.chat.max-tokens=2000
```

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

URL میں `/v1` رہنے دیں۔ Spring AI 2.x میں یہ قدر بغیر تبدیلی کے openai-java کلائنٹ کو جاتی ہے (`OpenAiSetup.calculateBaseUrl` اسے جوں کا توں لوٹاتا ہے)، اور وہ کلائنٹ `/chat/completions` جوڑتا ہے۔ جس ڈیفالٹ کی جگہ یہ لیتا ہے وہ `https://api.openai.com/v1` ہے۔

## کال کریں اور ٹیسٹ کریں

```java
import org.springframework.ai.chat.client.ChatClient;
import org.springframework.boot.CommandLineRunner;
import org.springframework.context.annotation.Bean;

@Bean
CommandLineRunner smokeTest(ChatClient.Builder builder) {
    return args -> {
        ChatClient chat = builder.build();
        System.out.println(chat.prompt().user("Say hello in five words.").call().content());
    };
}
```

ایپ شروع کریں۔ جواب پرنٹ ہو تو کلید، URL اور ماڈل ID درست ہیں۔

## BroadNet کے لیے اہم سیٹنگز

-   **`max-tokens`، `max-completion-tokens` نہیں۔** Spring AI کی دستاویزات کہتی ہیں کہ دونوں ایک ساتھ استعمال نہیں ہو سکتے اور دونوں سیٹ کرنا ایرر ہے۔ BroadNet کا API ریفرنس `max_tokens` بیان کرتا ہے۔ DeepSeek V4.1 Flash، GLM 5.3 اور Qwen3.8 27B پہلے ریزننگ کرتے ہیں، اور ریزننگ اسی حد میں گنی جاتی ہے۔
-   **ریزننگ کا متن۔** Spring AI ان OpenAI-compatible سرورز سے `reasoning_content` دکھا سکتا ہے جو اسے لوٹاتے ہیں۔ BroadNet کا API ریفرنس `usage` میں ریزننگ ٹوکنز کی گنتی بتاتا ہے مگر ریزننگ کے متن کا وعدہ نہیں کرتا، اس لیے اس پر انحصار نہ کریں۔
-   **صرف چیٹ کے لیے اوور رائیڈ۔** `spring.ai.openai.chat.base-url` اور `spring.ai.openai.chat.api-key` چیٹ ماڈل کے لیے مشترکہ پراپرٹیز پر ترجیح رکھتی ہیں۔ انہیں تب استعمال کریں جب Spring AI کے دوسرے OpenAI ماڈلز (جیسے embeddings) کو OpenAI پر ہی رہنا ہو۔
-   **ری ٹرائی۔** `spring.ai.retry.max-attempts` کا ڈیفالٹ 10 ہے، ایکسپونینشل بیک آف کے ساتھ۔ استعمال کے مطابق ادائیگی والی کلید پر اس سے فی منٹ کی حد جلد ختم ہو سکتی ہے؛ اسے کم کرنے پر غور کریں۔

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

| استعمال | `spring.ai.openai.chat.model` |
| --- | --- |
| ٹول کالنگ، اسٹرکچرڈ آؤٹ پٹ | `broadnet/glm-5.3` |
| تصاویر یا عربی متن | `broadnet/qwen3.8-27b` |
| لمبی دستاویزات، فلیٹ ریٹ پلان | `broadnet/deepseek-v4.1-flash` |
| مفت ابتدائی کریڈٹ | `broadnet/gemma-4-26b-a4b` |

[ہر ماڈل کی قیمتیں](https://broadrouter.com/ur/pricing/)۔

## مسائل کا حل

-   **401۔** کلید غلط ہے، ختم ہو چکی ہے یا الاؤنس ختم ہو گیا ہے، یا JVM کے لیے `BROADNET_API_KEY` سیٹ نہیں۔
-   **404۔** base URL میں `/v1` نہیں، یا ماڈل ID غلط ہے۔ پیڈ ماڈلز کے لیے ٹاپ اپ چاہیے؛ $5 کریڈٹ صرف `broadnet/gemma-4-26b-a4b` اور دو Transcribe ماڈلز کا احاطہ کرتا ہے۔
-   **خالی `content()`۔** ریزننگ نے آؤٹ پٹ بجٹ خرچ کر دیا۔ `max-tokens` بڑھائیں۔ [جوابات خالی کیوں آتے ہیں](https://broadrouter.com/ur/guides/reasoning-tokens-empty-response/)۔
-   **دونوں ٹوکن حدیں سیٹ ہونے پر 400۔** `max-completion-tokens` ہٹا دیں۔
-   **429۔** استعمال کے مطابق ادائیگی والی کلید فی منٹ 30 درخواستوں اور بیک وقت 4 جاری درخواستوں کی اجازت دیتی ہے۔ [ایررز اور ری ٹرائی](https://broadrouter.com/ur/guides/errors-and-retries/) دیکھیں۔

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

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

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

[ایمبیڈنگز (embeddings)](https://broadrouter.com/ur/glossary/embeddings/)

ایمبیڈنگز فلوٹنگ پوائنٹ اعداد کی فہرستیں (ویکٹرز) ہیں جو کوئی ماڈل متن، تصویر یا دوسرے ان پٹ کی نمائندگی کے لیے بناتا ہے۔ ملتے جلتے معنی والے ان پٹس کے ویکٹرز ایک دوسرے کے قریب ہوتے ہیں، اس لیے ویکٹرز کا فاصلہ سرچ نتائج کی درجہ بندی، دستاویزات کی گروہ بندی یا متعلقہ چیزوں کی تلاش میں کام آتا ہے۔

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

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

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

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

[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 کے ساتھ بدلنے سے وہی کوڈ کسی دوسرے فراہم کنندہ سے جڑ جاتا ہے۔

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

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

[ایکسپونینشل بیک آف (exponential backoff)](https://broadrouter.com/ur/glossary/exponential-backoff/)

ایکسپونینشل بیک آف دوبارہ کوشش کی ایک حکمتِ عملی ہے جس میں کلائنٹ ہر ناکام کوشش کے بعد، دوبارہ کوشش سے پہلے، زیادہ دیر انتظار کرتا ہے، عموماً تاخیر کو ایک حد تک دگنا کرتے ہوئے۔ ہر انتظار میں رینڈم jitter شامل کرنے سے کئی کلائنٹس کی دوبارہ کوششیں بکھر جاتی ہیں تاکہ وہ بیک وقت سرور تک نہ پہنچیں۔

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

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

## عام سوالات

### کیا spring.ai.openai.base-url میں /v1 ہونا چاہیے؟

ہاں۔ Spring AI 2.x میں یہ قدر بغیر تبدیلی کے openai-java کلائنٹ کو جاتی ہے، جس کا اپنا ڈیفالٹ https://api.openai.com/v1 ہے۔ https://inference.broadnet.ai/v1 استعمال کریں۔

### BroadNet کے ساتھ max-tokens استعمال کروں یا max-completion-tokens؟

max-tokens۔ Spring AI کی دستاویزات کہتی ہیں کہ دونوں ایک ساتھ استعمال نہیں ہو سکتے۔ BroadNet کا API ریفرنس max\_tokens فیلڈ بیان کرتا ہے، اور ریزننگ اس میں گنی جاتی ہے، اس لیے 1,000 یا زیادہ ٹوکن رکھیں۔

### کیا BroadNet کے ساتھ Spring AI کی ٹول کالنگ چلتی ہے؟

GLM 5.3 یا Qwen3.8 27B استعمال کریں، جنہیں BroadNet ٹولز کے ساتھ درج کرتا ہے۔ BroadNet کی دستاویزات DeepSeek V4.1 Flash کے لیے ٹول کالنگ درج نہیں کرتیں۔

### کیا embeddings کے لیے OpenAI اور چیٹ کے لیے BroadNet رکھ سکتے ہیں؟

ہاں۔ spring.ai.openai.chat.base-url اور spring.ai.openai.chat.api-key صرف چیٹ ماڈل کے لیے مشترکہ پراپرٹیز کو اوور رائیڈ کرتی ہیں۔ BroadNet کا API ریفرنس کوئی embeddings endpoint درج نہیں کرتا۔

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

-   [openai-go SDK سے Go میں BroadNet Inference کال کریں](https://broadrouter.com/ur/guides/openai-go-sdk/)
-   [BroadNet Inference کے ساتھ OpenAI Python SDK استعمال کریں](https://broadrouter.com/ur/guides/openai-python-sdk/)
-   [ریزننگ ماڈل خالی جواب کیوں لوٹاتا ہے](https://broadrouter.com/ur/guides/reasoning-tokens-empty-response/)
-   [BroadNet Inference کے ایرر کوڈز اور دوبارہ کوشش کب کریں](https://broadrouter.com/ur/guides/errors-and-retries/)
-   [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-spring-ai-openai-base-url&utm_content=page-cta) ·

**ذرائع**

-   [Spring AI ریفرنس، OpenAI Chat (2.0.2) (2026-11-15 کو جانچا گیا)](https://docs.spring.io/spring-ai/reference/api/chat/openai-chat.html)
-   [Spring AI سورس، v2.0.2 پر OpenAiSetup.calculateBaseUrl (2026-11-16 کو جانچا گیا)](https://github.com/spring-projects/spring-ai/blob/v2.0.2/models/spring-ai-openai/src/main/java/org/springframework/ai/openai/setup/OpenAiSetup.java)
-   [BroadNet Inference API ریفرنس (2026-11-15 کو جانچا گیا) (انگریزی میں)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ur-guides-spring-ai-openai-base-url&utm_content=sources)
