---
title: "openai-go میں کسٹم base URL (WithBaseURL) | BroadRouter"
description: "option.WithBaseURL سے آفیشل openai-go v3 SDK کو BroadNet Inference سے جوڑیں: Go میں چیٹ کمپلیشنز، usage کے ساتھ اسٹریمنگ اور ایرر ہینڈلنگ۔"
url: https://broadrouter.com/ur/guides/openai-go-sdk/
lang: ur
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# openai-go SDK سے Go میں BroadNet Inference کال کریں

اپ ڈیٹ 2026-11-16

github.com/openai/openai-go/v3 انسٹال کریں اور کلائنٹ کو option.WithBaseURL("https://inference.broadnet.ai/v1") اور اپنی BroadNet کلید والے option.WithAPIKey کے ساتھ بنائیں۔ client.Chat.Completions.New کو broadnet/glm-5.3 جیسے BroadNet ماڈل ID کے ساتھ، سادہ string کے طور پر کال کریں۔ Responses API نہیں، چیٹ کمپلیشنز استعمال کریں، اور MaxTokens میں ریزننگ کے لیے گنجائش رکھیں۔

`openai-go`، OpenAI کی آفیشل Go لائبریری ہے۔ یہ `option.WithBaseURL` سے کسٹم base URL لیتی ہے، اس لیے کسی بھی OpenAI-compatible API کو کال کر سکتی ہے۔ BroadNet Inference، `https://inference.broadnet.ai/v1` پر چیٹ کمپلیشنز فراہم کرتا ہے۔ BroadRouter، BroadNet کی اپنی سائٹ ہے۔ یہ گائیڈ v3.99.0 کے openai-go README کے مطابق ہے۔

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

```bash
go get -u 'github.com/openai/openai-go/v3@v3.99.0'
export BROADNET_API_KEY='your-broadnet-key'
```

موجودہ ریلیز کے لیے Go 1.26 یا نیا ورژن چاہیے۔

## Chat completion

```go
package main

import (
	"context"
	"fmt"
	"os"

	"github.com/openai/openai-go/v3"
	"github.com/openai/openai-go/v3/option"
)

func main() {
	client := openai.NewClient(
		option.WithBaseURL("https://inference.broadnet.ai/v1"),
		option.WithAPIKey(os.Getenv("BROADNET_API_KEY")),
	)

	resp, err := client.Chat.Completions.New(context.TODO(), openai.ChatCompletionNewParams{
		Model: "broadnet/glm-5.3",
		Messages: []openai.ChatCompletionMessageParamUnion{
			openai.SystemMessage("You are a concise Go reviewer."),
			openai.UserMessage("How do I check if a slice is empty in Go?"),
		},
		MaxTokens: openai.Int(2000), // reasoning counts toward this limit
	})
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Choices[0].Message.Content)
}
```

اسے `go run .` سے چلائیں۔ جواب پرنٹ ہو جائے تو یہی آپ کا ٹیسٹ ہے: کلید، URL اور ماڈل ID کام کر رہے ہیں۔

-   **Model** ایک سادہ string ہے۔ `openai.ChatModel`، `string` کا type alias ہے، اس لیے BroadNet ID کو کسی کنورژن کی ضرورت نہیں۔
-   **`Chat.Completions` استعمال کریں۔** README سب سے پہلے Responses API (`client.Responses.New`) دکھاتا ہے، جسے BroadNet درج نہیں کرتا۔ اس کا Chat Completions والا سیکشن کہتا ہے کہ وہ API “supported indefinitely” (ترجمہ: غیر معینہ مدت تک سپورٹڈ) ہے۔
-   **`MaxTokens` بمقابلہ `MaxCompletionTokens`۔** SDK، `max_tokens` کو deprecated قرار دے کر `max_completion_tokens` تجویز کرتا ہے، لیکن BroadNet کا API ریفرنس `max_tokens` بیان کرتا ہے۔ `MaxTokens` استعمال کریں۔
-   **`SystemMessage`، `DeveloperMessage` نہیں۔** README کی مثال میں `DeveloperMessage` ہے، جو `developer` رول بھیجتا ہے۔ BroadNet کا API ریفرنس اس رول کا ذکر نہیں کرتا، اس لیے `system` اور `user` استعمال کریں۔

## usage کے ساتھ اسٹریمنگ

```go
stream := client.Chat.Completions.NewStreaming(context.TODO(), openai.ChatCompletionNewParams{
	Model:     "broadnet/deepseek-v4.1-flash",
	Messages:  []openai.ChatCompletionMessageParamUnion{openai.UserMessage("Count from one to five.")},
	MaxTokens: openai.Int(2000),
	StreamOptions: openai.ChatCompletionStreamOptionsParam{
		IncludeUsage: openai.Bool(true),
	},
})
defer stream.Close()

for stream.Next() {
	chunk := stream.Current()
	if len(chunk.Choices) > 0 {
		fmt.Print(chunk.Choices[0].Delta.Content)
	}
	if chunk.Usage.TotalTokens > 0 {
		fmt.Printf("\n%d tokens\n", chunk.Usage.TotalTokens)
	}
}
if err := stream.Err(); err != nil {
	panic(err)
}
```

BroadNet کی دستاویزات کہتی ہیں کہ `stream_options.include_usage` کے true ہونے پر usage آخری چنک میں آتا ہے؛ اس چنک میں choices نہیں ہوتے، اسی لیے لمبائی کی جانچ ہے۔ وائر فارمیٹ کے لیے [چیٹ کمپلیشنز کی اسٹریمنگ](https://broadrouter.com/ur/guides/streaming-chat-completions/) دیکھیں۔

## ایررز اور دوبارہ کوشش

ناکام اسٹیٹس پر SDK `*openai.Error` لوٹاتا ہے۔ `errors.As` استعمال کریں اور `StatusCode` پڑھیں:

```go
var apierr *openai.Error
if errors.As(err, &apierr) && apierr.StatusCode == 429 {
	// back off, then retry
}
```

openai-go کچھ ایررز پر ڈیفالٹ طور پر دو بار، مختصر exponential backoff کے ساتھ دوبارہ کوشش کرتا ہے۔ اسے `option.WithMaxRetries(n)` سے بدلیں۔ دوبارہ کوششیں بھی BroadNet کی ریٹ لمٹس میں گنی جاتی ہیں۔

## مسائل کا حل

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

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

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

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

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

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

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

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

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

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

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

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

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

[ریٹ لمٹ (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 اپناتے ہیں۔

## عام سوالات

### کیا میں option کی جگہ انوائرنمنٹ ویری ایبلز سے BroadNet URL سیٹ کر سکتا ہوں؟

ہاں۔ openai-go ڈیفالٹ طور پر OPENAI\_API\_KEY اور OPENAI\_BASE\_URL پڑھتا ہے، اس لیے اگر دونوں میں BroadNet کی ویلیوز ہوں تو بغیر option کے openai.NewClient() چل جاتا ہے۔ واضح طور پر دیا گیا option.WithBaseURL، OPENAI\_BASE\_URL کو اوور رائیڈ کرتا ہے۔

### جب Model، openai.ChatModel مانگتا ہے تو BroadNet ماڈل ID کیسے دوں؟

openai-go میں ChatModel، string کا type alias ہے، اس لیے Model "broadnet/glm-5.3" جیسا ہے ویسا ہی کمپائل ہو جاتا ہے۔

### DeveloperMessage کی جگہ SystemMessage کیوں استعمال کریں؟

DeveloperMessage، developer رول بھیجتا ہے، جو OpenAI نے اپنے ماڈلز کے لیے متعارف کرایا تھا۔ BroadNet کا API ریفرنس اس رول کا ذکر نہیں کرتا، اس لیے معیاری system رول زیادہ محفوظ انتخاب ہے۔

### مجھے Go کا کون سا ورژن چاہیے؟

موجودہ openai-go v3 کے لیے Go 1.26 یا نیا ورژن چاہیے۔ اس کا README کہتا ہے کہ اگر آپ کو Go 1.25 پر ہی رہنا ہے تو v3.74.0 پن کریں۔

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

-   [BroadNet Inference کے ساتھ OpenAI Python SDK استعمال کریں](https://broadrouter.com/ur/guides/openai-python-sdk/)
-   [BroadNet Inference کے ساتھ OpenAI Node.js SDK استعمال کریں](https://broadrouter.com/ur/guides/openai-node-sdk/)
-   [chat completions اسٹریم کریں اور ٹوٹے کنکشن سنبھالیں](https://broadrouter.com/ur/guides/streaming-chat-completions/)
-   [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-openai-go-sdk&utm_content=page-cta) ·

**ذرائع**

-   [openai-go README (v3.99.0، Go 1.26+) (2026-11-15 کو جانچا گیا)](https://github.com/openai/openai-go)
-   [openai-go سورس، ChatCompletionNewParams اور option.WithBaseURL (2026-11-15 کو جانچا گیا)](https://github.com/openai/openai-go/blob/main/chatcompletion.go)
-   [BroadNet Inference API ریفرنس (2026-11-15 کو جانچا گیا) (انگریزی میں)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ur-guides-openai-go-sdk&utm_content=sources)
