---
title: "openai-go na may custom base URL (WithBaseURL) | BroadRouter"
description: "Gamitin ang opisyal na openai-go v3 SDK sa BroadNet Inference sa pamamagitan ng option.WithBaseURL, na may chat completions, streaming na may usage at mga error."
url: https://broadrouter.com/fil/guides/openai-go-sdk/
lang: fil
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Isinalin mula sa Ingles sa tulong ng AI. [Basahin ang orihinal sa Ingles](https://broadrouter.com/guides/openai-go-sdk/) (na-update noong 2026-11-16).

# Tawagin ang BroadNet Inference mula sa Go gamit ang openai-go SDK

Na-update 2026-11-16

I-install ang github.com/openai/openai-go/v3 at gawin ang client gamit ang option.WithBaseURL("https://inference.broadnet.ai/v1") at option.WithAPIKey na naka-set sa BroadNet key mo. Tawagin ang client.Chat.Completions.New na may BroadNet model ID gaya ng broadnet/glm-5.3 bilang simpleng string. Chat completions ang gamitin, hindi ang Responses API, at mag-set ng MaxTokens na may puwang para sa reasoning.

Ang `openai-go` ang opisyal na Go library ng OpenAI. Tumatanggap ito ng custom na base URL gamit ang `option.WithBaseURL`, kaya kaya nitong tawagin ang anumang OpenAI-compatible na API. Nagse-serve ang BroadNet Inference ng chat completions sa `https://inference.broadnet.ai/v1`. Sariling site ng BroadNet ang BroadRouter; sinusundan ng gabay na ito ang README ng openai-go para sa v3.99.0.

## I-install

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

Kailangan ng kasalukuyang release ang Go 1.26 o mas bago.

## 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)
}
```

Patakbuhin ito gamit ang `go run .`. Ang lumabas na sagot ang test mo: gumagana ang key, URL at model ID.

-   **Simpleng string ang Model.** Type alias ng `string` ang `openai.ChatModel`, kaya hindi na kailangang i-convert ang mga BroadNet ID.
-   **Gamitin ang `Chat.Completions`.** Responses API (`client.Responses.New`) ang unang ipinapakita ng README, at hindi ito nakalista sa BroadNet. Sinasabi ng seksiyon nito sa Chat Completions na ang API na iyon ay “supported indefinitely” (Salin: susuportahan nang walang takdang katapusan).
-   **`MaxTokens` kontra `MaxCompletionTokens`.** Minamarkahan ng SDK na deprecated ang `max_tokens` pabor sa `max_completion_tokens`, pero `max_tokens` ang inilalarawan ng API reference ng BroadNet. Gamitin ang `MaxTokens`.
-   **`SystemMessage`, hindi `DeveloperMessage`.** `DeveloperMessage` ang gamit ng halimbawa sa README, na nagpapadala ng `developer` role. Hindi binabanggit ng API reference ng BroadNet ang role na iyon, kaya `system` at `user` ang gamitin.

## Streaming na may 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)
}
```

Ayon sa docs ng BroadNet, dumarating ang usage sa huling chunk kapag true ang `stream_options.include_usage`; walang choices ang chunk na iyon, kaya may length check. Tingnan ang [streaming chat completions](https://broadrouter.com/fil/guides/streaming-chat-completions/) para sa wire format.

## Mga error at retry

Nagbabalik ang SDK ng `*openai.Error` para sa mga status na hindi success. Gamitin ang `errors.As` at basahin ang `StatusCode`:

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

Bilang default, dalawang beses nire-retry ng openai-go ang ilang error na may maikling exponential backoff. Baguhin ito gamit ang `option.WithMaxRetries(n)`. Kasama ang mga retry sa rate limits ng BroadNet.

## Troubleshooting

-   **401.** Mali, expired o ubos na ang allowance ng key. Kung hindi ka nagpasa ng `WithAPIKey`, `OPENAI_API_KEY` ang ginamit ng SDK.
-   **404.** Dapat nagtatapos sa `/v1` ang base URL, at sa `Chat.Completions` dapat pumunta ang tawag, hindi sa `Responses`. Pagkatapos, suriin ang model ID. Kailangan ng top-up para sa mga bayad na model; ang `broadnet/gemma-4-26b-a4b` at ang dalawang Transcribe model lang ang sakop ng $5 na credit.
-   **Walang laman na `Content`.** Naubos ng reasoning ang output budget. Taasan ang `MaxTokens`. [Bakit walang laman ang mga sagot](https://broadrouter.com/fil/guides/reasoning-tokens-empty-response/).
-   **429.** Ang isang pay-as-you-go key ay may 30 request kada minuto at 4 na sabay-sabay. Limitahan ang mga goroutine na sabay na tumatawag sa API. Tingnan ang [errors and retries](https://broadrouter.com/fil/guides/errors-and-retries/).

## Mga termino sa gabay na ito

[API key](https://broadrouter.com/fil/glossary/api-key/)

Ang API key ay isang lihim na string na kumikilala at nagpapahintulot sa client na tumatawag sa isang API. Kadalasang hinihingi ito ng mga LLM API sa Authorization: Bearer header, at ang sinumang may hawak ng key ay makakagawa ng mga request na sisingilin sa account na may-ari nito.

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

Ang Chat Completions API ay HTTP endpoint ng OpenAI, POST /v1/chat/completions, na tumatanggap ng pangalan ng model at listahan ng mga message na may role, at ibinabalik ang susunod na message ng model. Ang hugis ng request at response nito ang naging karaniwang format na ginagamit din ng mga OpenAI-compatible na provider at SDK.

[Pay-as-you-go](https://broadrouter.com/fil/glossary/pay-as-you-go/)

Ang pay-as-you-go ay paraan ng pagpepresyo kung saan ang nagamit mo lang ang binabayaran mo, sinusukat kada yunit gaya ng token, request o minuto ng audio, nang walang subscription o minimum na commitment. Ganito naniningil ang karamihan ng LLM API, mula sa prepaid na balance o sa pana-panahong invoice.

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

Ang base URL ay ang fixed na root address ng isang API, gaya ng https://api.example.com/v1, na idinudugtong ng client sa unahan ng bawat endpoint path, gaya ng /chat/completions. Sa mga OpenAI-compatible SDK, kapag pinalitan ang base URL, kasama ang API key at model ID, sa ibang provider na tatawag ang parehong code.

[Rate limit](https://broadrouter.com/fil/glossary/rate-limit/)

Ang rate limit ay hangganang itinatakda ng API sa dami ng paggamit ng isang client sa isang yugto ng oras, gaya ng request kada minuto o token kada minuto. Tinatanggihan ang mga request na lampas sa limit, kadalasan na may HTTP 429 Too Many Requests, hanggang bumaba ulit ang paggamit.

[Streaming](https://broadrouter.com/fil/glossary/streaming/)

Ang streaming ay paraan ng pagbabalik ng sagot ng language model nang paunti-unting chunk habang binubuo pa ito, sa halip na iisang sagot sa dulo. Sa mga OpenAI-compatible na API, dumadaan ang streaming sa server-sent events kapag naka-set sa true ang stream sa request.

[Concurrency](https://broadrouter.com/fil/glossary/concurrency/)

Ang concurrency ay ang bilang ng request na sabay-sabay na in flight mula sa isang client. Madalas itong nililimitahan ng mga LLM API kada key o plan, hiwalay sa requests per minute, dahil humahawak ng GPU capacity ang bawat bukas na request hanggang matapos ang response nito.

[Exponential backoff](https://broadrouter.com/fil/glossary/exponential-backoff/)

Ang exponential backoff ay estratehiya sa pag-retry kung saan mas matagal na naghihintay ang client pagkatapos ng bawat pumalyang attempt, kadalasang dinodoble ang delay hanggang sa isang cap, bago sumubok ulit. Ikinakalat ng random na jitter sa bawat paghihintay ang mga retry ng maraming client para hindi sila sabay-sabay na tumama sa server.

## Mga tanong

### Puwede ko bang i-set ang BroadNet URL gamit ang environment variables sa halip na options?

Oo. Binabasa ng openai-go ang OPENAI\_API\_KEY at OPENAI\_BASE\_URL bilang default, kaya gagana ang openai.NewClient() nang walang options kung BroadNet values ang laman ng dalawa. Nangingibabaw ang tahasang option.WithBaseURL sa OPENAI\_BASE\_URL.

### Paano ko ipapasa ang BroadNet model ID kung openai.ChatModel ang hinihingi ng Model?

Sa openai-go, type alias ng string ang ChatModel, kaya nagko-compile ang Model "broadnet/glm-5.3" nang walang binabago.

### Bakit SystemMessage at hindi DeveloperMessage?

Ipinapadala ng DeveloperMessage ang developer role, na ipinakilala ng OpenAI para sa sarili nitong mga model. Hindi binabanggit ng API reference ng BroadNet ang role na iyon, kaya mas ligtas ang karaniwang system role.

### Anong bersyon ng Go ang kailangan ko?

Kailangan ng kasalukuyang openai-go v3 ang Go 1.26 o mas bago. Sinasabi ng README nito na i-pin ang v3.74.0 kung kailangan mong manatili sa Go 1.25.

## Mga kaugnay na gabay

-   [Paano gamitin ang OpenAI Python SDK sa BroadNet Inference](https://broadrouter.com/fil/guides/openai-python-sdk/)
-   [Paano gamitin ang OpenAI Node.js SDK sa BroadNet Inference](https://broadrouter.com/fil/guides/openai-node-sdk/)
-   [Paano mag-stream ng chat completions at ayusin ang naputol na stream](https://broadrouter.com/fil/guides/streaming-chat-completions/)
-   [Mga error code ng BroadNet Inference at kailan dapat mag-retry](https://broadrouter.com/fil/guides/errors-and-retries/)
-   [Lahat ng tool na gumagana sa BroadNet Inference (Ingles)](https://broadrouter.com/integrations/): mga SDK, coding agent, chat UI at automation tool, kasama ang eksaktong setting ng bawat isa

Subukan ito sa totoong workload mo. May US$5 na panimulang credit ang mga bagong account para sa Gemma at transcription. Kailangan ng top-up para sa DeepSeek, GLM, at Qwen3.8.

[Magsimula](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=fil-guides-openai-go-sdk&utm_content=page-cta) ·

**Mga source**

-   [README ng openai-go (v3.99.0, Go 1.26+) (sinuri noong 2026-11-15)](https://github.com/openai/openai-go)
-   [Source code ng openai-go, ChatCompletionNewParams at option.WithBaseURL (sinuri noong 2026-11-15)](https://github.com/openai/openai-go/blob/main/chatcompletion.go)
-   [API reference ng BroadNet Inference (sinuri noong 2026-11-15) (Ingles)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fil-guides-openai-go-sdk&utm_content=sources)
