---
title: "openai-go 自定义 base URL（WithBaseURL）配置 | BroadRouter"
description: "通过 option.WithBaseURL，用官方 openai-go v3 SDK 调用 BroadNet Inference：Go 里的对话补全、带用量统计的流式输出和错误处理。"
url: https://broadrouter.com/zh/guides/openai-go-sdk/
lang: zh-Hans
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 更新）。

# 用 Go 和 openai-go SDK 调用 BroadNet Inference

更新于 2026-11-16

安装 github.com/openai/openai-go/v3，创建客户端时传入 option.WithBaseURL("https://inference.broadnet.ai/v1")，并用 option.WithAPIKey 设置你的 BroadNet 密钥。调用 client.Chat.Completions.New，模型 ID 直接写成字符串，例如 broadnet/glm-5.3。请使用对话补全而不是 Responses API，并给 MaxTokens 留出思考的空间。

`openai-go` 是 OpenAI 官方的 Go 库。它可以通过 `option.WithBaseURL` 指定自定义 base URL，因此能调用任何 OpenAI 兼容 API。BroadNet Inference 在 `https://inference.broadnet.ai/v1` 上提供对话补全。BroadRouter 是 BroadNet 自己的网站；本文依据 openai-go v3.99.0 的 README。

## 安装

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

当前版本需要 Go 1.26 或更高版本。

## 对话补全

```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** 就是普通字符串。`openai.ChatModel` 是 `string` 的类型别名，所以 BroadNet 的 ID 不需要转换。
-   **使用 `Chat.Completions`。** README 首先介绍的是 Responses API（`client.Responses.New`），而 BroadNet 没有列出这个 API。README 的 Chat Completions 一节说该 API “supported indefinitely”（译文：会无限期支持）。
-   **`MaxTokens` 还是 `MaxCompletionTokens`。** SDK 把 `max_tokens` 标为已弃用，推荐改用 `max_completion_tokens`，但 BroadNet 的 API 参考文档描述的是 `max_tokens`。请使用 `MaxTokens`。
-   **用 `SystemMessage`，不用 `DeveloperMessage`。** README 示例用的是 `DeveloperMessage`，它发送的是 `developer` 角色。BroadNet 的 API 参考文档没有提到这个角色，所以请用 `system` 和 `user`。

## 带用量统计的流式输出

```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 时，用量会出现在最后一个 chunk 中；这个 chunk 没有 choices，所以代码里要先检查长度。数据格式见[流式对话补全](https://broadrouter.com/zh/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 默认会对部分错误重试两次，使用较短的指数退避。可以用 `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/zh/guides/reasoning-tokens-empty-response/)。
-   **429。** 按量付费密钥每分钟允许 30 个请求，同时最多 4 个在处理中。请限制同时调用 API 的 goroutine 数量。见[错误码与重试](https://broadrouter.com/zh/guides/errors-and-retries/)。

## 本指南涉及的术语

[Base URL（base\_url）](https://broadrouter.com/zh/glossary/base-url/)

base URL 是 API 固定的根地址，例如 https://api.example.com/v1，客户端会把它加在每个端点路径（例如 /chat/completions）前面。在 OpenAI 兼容 SDK 中，修改 base URL，再配合 API 密钥和模型 ID，就能让同一份代码改用另一家服务商。

[按量付费（pay-as-you-go）](https://broadrouter.com/zh/glossary/pay-as-you-go/)

按量付费是一种计价模式：你只为实际用量付费，按 token、请求次数或音频分钟等单位计量，没有订阅费，也没有最低消费承诺。大多数大模型 API 都这样计费，从预付余额中扣减或定期开具账单。

[速率限制（rate limit）](https://broadrouter.com/zh/glossary/rate-limit/)

速率限制是 API 对客户端在一个时间窗口内的使用量设定的上限，例如每分钟请求数或每分钟 token 数。超出限制的请求会被拒绝，通常返回 HTTP 429 Too Many Requests，直到用量回落到限制以下。

[并发（concurrency）](https://broadrouter.com/zh/glossary/concurrency/)

并发（concurrency）是客户端在同一时刻正在进行中的请求数。大模型 API 往往按密钥或套餐单独限制并发，与每分钟请求数分开计算，因为每个未完成的请求在响应结束前都会占用 GPU 资源。

[Chat Completions API（对话补全接口）](https://broadrouter.com/zh/glossary/chat-completions-api/)

Chat Completions API 是 OpenAI 的 HTTP 端点 POST /v1/chat/completions，它接收模型名称和一组带角色标记的消息，返回模型的下一条消息。它的请求与响应结构已成为 OpenAI 兼容服务商和各类 SDK 通用的格式。

## 常见问题

### 可以用环境变量而不是 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 的类型别名，所以直接写 Model "broadnet/glm-5.3" 就能编译通过。

### 为什么用 SystemMessage 而不是 DeveloperMessage？

DeveloperMessage 发送的是 developer 角色，这是 OpenAI 为自家模型引入的。BroadNet 的 API 参考文档没有提到这个角色，所以用标准的 system 角色更稳妥。

### 需要哪个版本的 Go？

当前的 openai-go v3 需要 Go 1.26 或更高版本。它的 README 说，如果必须停留在 Go 1.25，请固定使用 v3.74.0。

## 相关指南

-   [用 OpenAI Python SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/openai-python-sdk/)
-   [用 OpenAI Node.js SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/openai-node-sdk/)
-   [对话补全的流式输出，以及连接中断的处理](https://broadrouter.com/zh/guides/streaming-chat-completions/)
-   [BroadNet Inference 错误码，以及什么时候该重试](https://broadrouter.com/zh/guides/errors-and-retries/)
-   [所有可与 BroadNet Inference 配合使用的工具（英文）](https://broadrouter.com/integrations/)：SDK、编程智能体、聊天界面和自动化工具，并附每个工具的具体设置

用你的真实业务负载试一试。新账户可获得 US$5 初始额度，用于 Gemma和转写。DeepSeek、GLM和Qwen3.8 需要先充值。

[开始使用](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-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=zh-guides-openai-go-sdk&utm_content=sources)
