---
title: "openai-go dengan base URL tersuai (WithBaseURL) | BroadRouter"
description: "Guna SDK rasmi openai-go v3 dengan BroadNet Inference melalui option.WithBaseURL, termasuk chat completions, penstriman dengan usage dan pengendalian ralat."
url: https://broadrouter.com/ms/guides/openai-go-sdk/
lang: ms
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan daripada bahasa Inggeris dengan bantuan AI. [Baca versi asal dalam bahasa Inggeris](https://broadrouter.com/guides/openai-go-sdk/) (dikemas kini 2026-11-16).

# Panggil BroadNet Inference daripada Go dengan SDK openai-go

Dikemas kini 2026-11-16

Pasang github.com/openai/openai-go/v3 dan cipta klien dengan option.WithBaseURL("https://inference.broadnet.ai/v1") dan option.WithAPIKey yang ditetapkan kepada kunci BroadNet anda. Panggil client.Chat.Completions.New dengan ID model BroadNet seperti broadnet/glm-5.3 sebagai rentetan biasa. Gunakan chat completions, bukan Responses API, dan tetapkan MaxTokens dengan ruang untuk penaakulan.

`openai-go` ialah pustaka Go rasmi OpenAI. Ia menerima base URL tersuai melalui `option.WithBaseURL`, jadi ia boleh memanggil mana-mana API serasi OpenAI. BroadNet Inference menyediakan chat completions di `https://inference.broadnet.ai/v1`. BroadRouter ialah laman web BroadNet sendiri; panduan ini mengikut README openai-go untuk v3.99.0.

## Pasang

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

Keluaran semasa memerlukan Go 1.26 atau lebih baharu.

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

Jalankannya dengan `go run .`. Jawapan yang dicetak ialah ujian anda: kunci, URL dan ID model berfungsi.

-   **Model ialah rentetan biasa.** `openai.ChatModel` ialah type alias bagi `string`, jadi ID BroadNet tidak perlu ditukar.
-   **Gunakan `Chat.Completions`.** README mendahulukan Responses API (`client.Responses.New`), yang tidak disenaraikan oleh BroadNet. Bahagian Chat Completions dalam README menyatakan API itu “supported indefinitely” (Terjemahan: disokong tanpa had masa).
-   **`MaxTokens` berbanding `MaxCompletionTokens`.** SDK menandakan `max_tokens` sebagai deprecated dan memihak kepada `max_completion_tokens`, tetapi rujukan API BroadNet menerangkan `max_tokens`. Gunakan `MaxTokens`.
-   **`SystemMessage`, bukan `DeveloperMessage`.** Contoh README menggunakan `DeveloperMessage`, yang menghantar peranan `developer`. Rujukan API BroadNet tidak menyebut peranan itu, jadi gunakan `system` dan `user`.

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

Dokumentasi BroadNet menyatakan usage tiba dalam chunk terakhir apabila `stream_options.include_usage` bernilai true; chunk itu tiada choices, sebab itulah ada semakan panjang. Lihat [penstriman chat completions](https://broadrouter.com/ms/guides/streaming-chat-completions/) untuk format wayarnya.

## Ralat dan cuba semula

SDK memulangkan `*openai.Error` untuk status yang tidak berjaya. Gunakan `errors.As` dan baca `StatusCode`:

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

Secara lalai, openai-go mencuba semula sesetengah ralat dua kali dengan backoff eksponen yang singkat. Ubahnya dengan `option.WithMaxRetries(n)`. Cubaan semula turut dikira dalam had kadar BroadNet.

## Penyelesaian masalah

-   **401.** Kunci salah, tamat tempoh atau kehabisan elaun. Jika anda tidak menghantar `WithAPIKey`, SDK menggunakan `OPENAI_API_KEY`.
-   **404.** Base URL mesti berakhir dengan `/v1`, dan panggilan mesti ke `Chat.Completions`, bukan `Responses`. Kemudian semak ID model. Model berbayar memerlukan tambah nilai; kredit $5 hanya meliputi `broadnet/gemma-4-26b-a4b` dan dua model Transcribe.
-   **`Content` kosong.** Penaakulan telah menggunakan bajet output. Naikkan `MaxTokens`. [Mengapa jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/).
-   **429.** Kunci bayar ikut guna membenarkan 30 permintaan seminit dan 4 serentak. Hadkan goroutine yang memanggil API pada masa yang sama. Lihat [ralat dan cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/).

## Istilah dalam panduan ini

[Bayar ikut guna (pay-as-you-go)](https://broadrouter.com/ms/glossary/pay-as-you-go/)

Bayar ikut guna ialah model harga di mana anda hanya membayar apa yang anda guna, dimeter mengikut unit seperti token, permintaan atau minit audio, tanpa langganan atau komitmen minimum. Kebanyakan API LLM mengebil dengan cara ini, daripada baki prabayar atau invois berkala.

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

Chat Completions API ialah endpoint HTTP OpenAI, POST /v1/chat/completions, yang menerima nama model dan senarai mesej bertanda peranan, lalu memulangkan mesej seterusnya daripada model. Bentuk permintaan dan responsnya menjadi format biasa yang digunakan semula oleh penyedia dan SDK yang serasi OpenAI.

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

Base URL ialah alamat akar tetap sesuatu API, seperti https://api.example.com/v1, yang diletakkan oleh klien di hadapan setiap laluan endpoint, seperti /chat/completions. Dalam SDK serasi OpenAI, menukar base URL, bersama kunci API dan ID model, menghalakan kod yang sama kepada penyedia lain.

[Keserentakan (concurrency)](https://broadrouter.com/ms/glossary/concurrency/)

Keserentakan ialah bilangan permintaan yang sedang berjalan serentak daripada satu klien. API LLM sering mengehadkannya bagi setiap kunci atau pelan, berasingan daripada permintaan seminit, kerana setiap permintaan yang terbuka memegang kapasiti GPU sehingga responsnya selesai.

[API serasi OpenAI (OpenAI-compatible API)](https://broadrouter.com/ms/glossary/openai-compatible-api/)

API serasi OpenAI ialah API HTTP yang menerima format permintaan dan respons yang sama seperti OpenAI API, contohnya POST /v1/chat/completions, jadi SDK dan alat OpenAI boleh menggunakannya dengan hanya menukar base URL, kunci API dan nama model.

[Backoff eksponen (exponential backoff)](https://broadrouter.com/ms/glossary/exponential-backoff/)

Backoff eksponen ialah strategi cuba semula di mana klien menunggu lebih lama selepas setiap percubaan yang gagal, biasanya menggandakan kelewatan sehingga had tertentu, sebelum mencuba lagi. Menambah jitter rawak pada setiap penantian menyebarkan cubaan semula daripada banyak klien supaya mereka tidak mengenai pelayan pada saat yang sama.

[Had kadar (rate limit)](https://broadrouter.com/ms/glossary/rate-limit/)

Had kadar ialah had yang ditetapkan oleh API ke atas jumlah penggunaan klien dalam satu tempoh masa, seperti permintaan seminit atau token seminit. Permintaan yang melebihi had ditolak, biasanya dengan HTTP 429 Too Many Requests, sehingga penggunaan turun semula di bawahnya.

[Kredit prabayar (prepaid credit)](https://broadrouter.com/ms/glossary/prepaid-credit/)

Kredit prabayar ialah wang yang ditambah ke akaun API sebelum digunakan. Setiap permintaan menolak kosnya daripada baki, dan apabila baki habis, permintaan bermeter berhenti sehingga anda menambah nilai. Ia mengehadkan perbelanjaan kepada jumlah yang telah anda bayar.

## Soalan lazim

### Bolehkah saya menetapkan URL BroadNet dengan pemboleh ubah persekitaran dan bukan options?

Boleh. openai-go membaca OPENAI\_API\_KEY dan OPENAI\_BASE\_URL secara lalai, jadi openai.NewClient() tanpa options berfungsi jika kedua-duanya menyimpan nilai BroadNet. option.WithBaseURL yang ditetapkan secara eksplisit mengatasi OPENAI\_BASE\_URL.

### Bagaimanakah saya menghantar ID model BroadNet apabila Model menjangkakan openai.ChatModel?

Dalam openai-go, ChatModel ialah type alias bagi string, jadi Model "broadnet/glm-5.3" boleh dikompil terus.

### Mengapakah guna SystemMessage dan bukan DeveloperMessage?

DeveloperMessage menghantar peranan developer, yang diperkenalkan oleh OpenAI untuk model-modelnya sendiri. Rujukan API BroadNet tidak menyebut peranan itu, jadi peranan system yang standard ialah pilihan yang lebih selamat.

### Versi Go manakah yang saya perlukan?

openai-go v3 semasa memerlukan Go 1.26 atau lebih baharu. README-nya menyatakan supaya menyemat v3.74.0 jika anda perlu kekal pada Go 1.25.

## Panduan berkaitan

-   [Cara guna OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-python-sdk/)
-   [Cara guna OpenAI Node.js SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-node-sdk/)
-   [Strim chat completions dan kendalikan sambungan yang terputus](https://broadrouter.com/ms/guides/streaming-chat-completions/)
-   [Kod ralat BroadNet Inference dan bila perlu cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/)
-   [Semua alat yang berfungsi dengan BroadNet Inference (Bahasa Inggeris)](https://broadrouter.com/integrations/): SDK, ejen pengekodan, antara muka sembang dan alat automasi, dengan tetapan tepat bagi setiap satu

Cuba dengan beban kerja sebenar anda. Akaun baharu bermula dengan kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM dan Qwen3.8 memerlukan tambah nilai.

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

**Sumber**

-   [README openai-go (v3.99.0, Go 1.26+) (disemak 2026-11-15)](https://github.com/openai/openai-go)
-   [Kod sumber openai-go, ChatCompletionNewParams dan option.WithBaseURL (disemak 2026-11-15)](https://github.com/openai/openai-go/blob/main/chatcompletion.go)
-   [Rujukan API BroadNet Inference (disemak 2026-11-15) (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-openai-go-sdk&utm_content=sources)
