---
title: "openai-go với base URL tùy chỉnh (WithBaseURL) | BroadRouter"
description: "Dùng SDK chính thức openai-go v3 với BroadNet Inference qua option.WithBaseURL: chat completions, streaming kèm usage và xử lý lỗi trong Go."
url: https://broadrouter.com/vi/guides/openai-go-sdk/
lang: vi
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Được dịch từ tiếng Anh với sự hỗ trợ của AI. [Đọc bản gốc tiếng Anh](https://broadrouter.com/guides/openai-go-sdk/) (cập nhật ngày 2026-11-16).

# Gọi BroadNet Inference từ Go bằng SDK openai-go

Cập nhật 2026-11-16

Cài github.com/openai/openai-go/v3 và tạo client với option.WithBaseURL("https://inference.broadnet.ai/v1") cùng option.WithAPIKey chứa key BroadNet. Gọi client.Chat.Completions.New với model ID BroadNet như broadnet/glm-5.3 dưới dạng chuỗi thường. Hãy dùng chat completions, không dùng Responses API, và đặt MaxTokens đủ chỗ cho phần suy luận.

`openai-go` là thư viện Go chính thức của OpenAI. Nó nhận base URL tùy chỉnh qua `option.WithBaseURL`, nên có thể gọi bất kỳ API tương thích OpenAI nào. BroadNet Inference phục vụ chat completions tại `https://inference.broadnet.ai/v1`. BroadRouter là website của chính BroadNet; bài này làm theo README của openai-go cho v3.99.0.

## Cài đặt

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

Bản phát hành hiện tại cần Go 1.26 trở lên.

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

Chạy bằng `go run .`. Câu trả lời được in ra chính là phép thử của bạn: key, URL và model ID đều hoạt động.

-   **Model** là chuỗi thường. `openai.ChatModel` là type alias của `string`, nên ID của BroadNet không cần chuyển đổi.
-   **Dùng `Chat.Completions`.** README giới thiệu Responses API (`client.Responses.New`) trước, nhưng BroadNet không liệt kê API này. Phần Chat Completions của README nói API đó được “supported indefinitely” (Bản dịch: hỗ trợ vô thời hạn).
-   **`MaxTokens` hay `MaxCompletionTokens`.** SDK đánh dấu `max_tokens` là deprecated để thay bằng `max_completion_tokens`, nhưng tài liệu tham chiếu API của BroadNet mô tả `max_tokens`. Hãy dùng `MaxTokens`.
-   **`SystemMessage`, không phải `DeveloperMessage`.** Ví dụ trong README dùng `DeveloperMessage`, thứ gửi role `developer`. Tài liệu tham chiếu API của BroadNet không nhắc tới role đó, nên hãy dùng `system` và `user`.

## Streaming kèm 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)
}
```

Tài liệu BroadNet nói usage tới trong chunk cuối cùng khi `stream_options.include_usage` là true; chunk đó không có choices, vì vậy mới cần kiểm tra độ dài. Xem [streaming chat completions](https://broadrouter.com/vi/guides/streaming-chat-completions/) để biết định dạng truyền.

## Lỗi và thử lại

SDK trả về `*openai.Error` cho các status không thành công. Dùng `errors.As` và đọc `StatusCode`:

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

Mặc định openai-go thử lại một số lỗi hai lần với backoff lũy thừa ngắn. Đổi bằng `option.WithMaxRetries(n)`. Các lần thử lại cũng tính vào giới hạn request của BroadNet.

## Xử lý sự cố

-   **401.** Key bị sai, hết hạn hoặc hết hạn mức. Nếu bạn không truyền `WithAPIKey`, SDK đã dùng `OPENAI_API_KEY`.
-   **404.** Base URL phải kết thúc bằng `/v1`, và lời gọi phải tới `Chat.Completions`, không phải `Responses`. Sau đó kiểm tra model ID. Các model trả phí cần nạp tiền; tín dụng $5 chỉ dùng được cho `broadnet/gemma-4-26b-a4b` và hai model Transcribe.
-   **`Content` rỗng.** Phần suy luận đã dùng hết ngân sách đầu ra. Hãy tăng `MaxTokens`. [Vì sao câu trả lời trả về rỗng](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/).
-   **429.** Key trả theo mức dùng cho phép 30 request mỗi phút và 4 request đang xử lý. Hãy giới hạn số goroutine gọi API cùng lúc. Xem [lỗi và thử lại](https://broadrouter.com/vi/guides/errors-and-retries/).

## Thuật ngữ trong hướng dẫn này

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

Chat Completions API là endpoint HTTP của OpenAI, POST /v1/chat/completions, nhận tên model và danh sách message có gắn vai trò rồi trả về message tiếp theo của model. Cấu trúc request và response của nó đã trở thành định dạng chung mà các nhà cung cấp và SDK tương thích OpenAI dùng lại.

[Giới hạn tần suất (rate limit)](https://broadrouter.com/vi/glossary/rate-limit/)

Giới hạn tần suất (rate limit) là mức trần mà API đặt ra cho lượng sử dụng của một client trong một khoảng thời gian, như số request mỗi phút hoặc số token mỗi phút. Request vượt giới hạn bị từ chối, thường với HTTP 429 Too Many Requests, cho đến khi mức dùng giảm xuống dưới giới hạn.

[Trả theo mức dùng (pay-as-you-go)](https://broadrouter.com/vi/glossary/pay-as-you-go/)

Trả theo mức dùng (pay-as-you-go) là mô hình giá mà bạn chỉ trả cho những gì đã dùng, đo theo đơn vị như token, request hoặc phút âm thanh, không có gói đăng ký hay cam kết tối thiểu. Hầu hết API LLM tính phí theo cách này, trừ vào số dư trả trước hoặc qua hóa đơn định kỳ.

[API tương thích OpenAI (OpenAI-compatible API)](https://broadrouter.com/vi/glossary/openai-compatible-api/)

API tương thích OpenAI là một HTTP API nhận cùng định dạng request và phản hồi như OpenAI API, ví dụ POST /v1/chat/completions, nên SDK và công cụ của OpenAI dùng được nó chỉ bằng cách đổi base URL, API key và tên model.

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

Base URL là địa chỉ gốc cố định của một API, như https://api.example.com/v1, mà client đặt trước mọi đường dẫn endpoint, như /chat/completions. Trong SDK tương thích OpenAI, đổi base URL cùng với API key và model ID sẽ trỏ cùng một đoạn code sang nhà cung cấp khác.

[Streaming (trả phản hồi dạng luồng)](https://broadrouter.com/vi/glossary/streaming/)

Streaming là cách trả phản hồi của model ngôn ngữ thành từng chunk nhỏ ngay trong lúc nó đang được sinh, thay vì một câu trả lời trọn vẹn ở cuối. Các API tương thích OpenAI stream qua server-sent events khi request đặt stream là true.

[Concurrency (request đồng thời)](https://broadrouter.com/vi/glossary/concurrency/)

Concurrency (request đồng thời) là số request mà một client đang xử lý cùng lúc. Các API LLM thường giới hạn nó theo key hoặc theo gói, tách biệt với số request mỗi phút, vì mỗi request đang mở chiếm dụng năng lực GPU cho tới khi response kết thúc.

[Exponential backoff (lùi thời gian theo cấp số nhân)](https://broadrouter.com/vi/glossary/exponential-backoff/)

Exponential backoff là chiến lược thử lại trong đó client chờ lâu hơn sau mỗi lần thất bại trước khi thử tiếp, thường nhân đôi độ trễ cho tới một mức trần. Thêm jitter ngẫu nhiên vào mỗi lần chờ giúp dàn trải các lần thử lại từ nhiều client để chúng không đổ dồn vào server cùng lúc.

## Câu hỏi thường gặp

### Có thể đặt URL BroadNet bằng biến môi trường thay vì option không?

Có. Mặc định openai-go đọc OPENAI\_API\_KEY và OPENAI\_BASE\_URL, nên openai.NewClient() không kèm option nào vẫn chạy nếu cả hai biến chứa giá trị của BroadNet. Một option.WithBaseURL được đặt rõ ràng sẽ ghi đè OPENAI\_BASE\_URL.

### Làm sao truyền model ID BroadNet khi trường Model yêu cầu openai.ChatModel?

Trong openai-go, ChatModel là type alias của string, nên Model: "broadnet/glm-5.3" biên dịch được ngay.

### Vì sao dùng SystemMessage thay vì DeveloperMessage?

DeveloperMessage gửi role developer, role mà OpenAI đưa ra cho các model của chính họ. Tài liệu tham chiếu API của BroadNet không nhắc tới role này, nên role system chuẩn là lựa chọn an toàn hơn.

### Cần phiên bản Go nào?

openai-go v3 hiện tại cần Go 1.26 trở lên. README của nó nói nên ghim v3.74.0 nếu bạn buộc phải ở lại Go 1.25.

## Hướng dẫn liên quan

-   [Dùng OpenAI Python SDK với BroadNet Inference](https://broadrouter.com/vi/guides/openai-python-sdk/)
-   [Dùng OpenAI Node.js SDK với BroadNet Inference](https://broadrouter.com/vi/guides/openai-node-sdk/)
-   [Streaming chat completions và xử lý khi mất kết nối](https://broadrouter.com/vi/guides/streaming-chat-completions/)
-   [Mã lỗi BroadNet Inference và khi nào nên thử lại](https://broadrouter.com/vi/guides/errors-and-retries/)
-   [Mọi công cụ dùng được với BroadNet Inference (tiếng Anh)](https://broadrouter.com/integrations/): SDK, agent lập trình, giao diện chat và công cụ tự động hóa, kèm cấu hình chính xác cho từng công cụ

Hãy thử với khối lượng công việc thực tế của bạn. Tài khoản mới được tặng US$5 tín dụng ban đầu cho Gemma và chuyển giọng nói thành văn bản. DeepSeek, GLM và Qwen3.8 cần nạp tiền.

[Bắt đầu](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-openai-go-sdk&utm_content=page-cta) ·

**Nguồn**

-   [README của openai-go (v3.99.0, Go 1.26 trở lên) (kiểm tra ngày 2026-11-15)](https://github.com/openai/openai-go)
-   [Mã nguồn openai-go, ChatCompletionNewParams và option.WithBaseURL (kiểm tra ngày 2026-11-15)](https://github.com/openai/openai-go/blob/main/chatcompletion.go)
-   [Tài liệu tham chiếu API BroadNet Inference (kiểm tra ngày 2026-11-15) (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-openai-go-sdk&utm_content=sources)
