使用 openai-go 在 Go 中发出第一个请求：base URL、密钥、usage

你已经有与 OpenAI 风格 API 通信的 Go 代码，或者即将编写一些。要把它发送到 CheapTokens，你只需更改客户端上的两个选项和一个字符串，即模型 id。SDK 保持不变：官方 openai-go 包，v3。

下面是完整程序，然后说明每一行做什么、如何读取答案和 token 计数，以及如何阻止卡住的请求挂起你的服务。版本已对照 2026 年 11 月 3 日的 openai-go README 检查：该页面上最新的标签是 v3.91.1，它需要 Go 1.26 或更新版本。

开始前你需要什么#

• Go 1.26 或更新版本。在 Go 1.25 上固定 v3.74.0；在 Go 1.22–1.24 上固定 v3.44.0（README 说较旧的行不保证修复）。
• 一个 CheapTokens API 密钥。把它放在环境变量中，而不是源文件中。
• API 地址：https://api.cheaptokens.dev/v1。它使用 OpenAI Chat Completions 格式，因此 openai-go 无需包装器即可工作。文档 有相同的地址和密钥页面。
• 一个模型 id。我们使用 deepseek-ai/DeepSeek-V4-Flash-0731：380K 上下文，一次回答最多 32,768 个 token。使用完整 id；价格表中的短名称不被 API 接受。

go mod init example.com/first-request
go get -u 'github.com/openai/openai-go/[email protected]'

export CHEAPTOKENS_API_KEY="paste-your-key-here"

完整程序#

package main

import (
	"context"
	"fmt"
	"log"
	"os"
	"time"

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

func main() {
	client := openai.NewClient(
		option.WithBaseURL("https://api.cheaptokens.dev/v1"),
		option.WithAPIKey(os.Getenv("CHEAPTOKENS_API_KEY")),
		option.WithMaxRetries(2),
		option.WithRequestTimeout(30*time.Second),
	)

	ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute)
	defer cancel()

	resp, err := client.Chat.Completions.New(ctx, openai.ChatCompletionNewParams{
		Model: "deepseek-ai/DeepSeek-V4-Flash-0731",
		Messages: []openai.ChatCompletionMessageParamUnion{
			openai.UserMessage("Explain in two sentences what a token is."),
		},
	})
	if err != nil {
		log.Fatal(err)
	}
	if len(resp.Choices) == 0 {
		log.Fatal("no choices in the response")
	}

	fmt.Println(resp.Choices[0].Message.Content)
	fmt.Println("finish_reason:", resp.Choices[0].FinishReason)
	fmt.Println("input tokens:", resp.Usage.PromptTokens)
	fmt.Println("output tokens:", resp.Usage.CompletionTokens)
	fmt.Println("total tokens:", resp.Usage.TotalTokens)
}

重要的部分：

• option.WithBaseURL(...) 是唯一将 SDK 从 OpenAI 移到 CheapTokens 的行。完全按照文档中的地址使用。
• option.WithAPIKey(os.Getenv(...)) 显式传递密钥。没有它，客户端会读取 OPENAI_API_KEY，这在移植现有代码时很方便：将该变量设置为 CheapTokens 密钥，代码无需更改密钥。OPENAI_BASE_URL 也是如此，但显式的 WithBaseURL 会覆盖它，因此如果两者都存在，也不会有意外。
• Model 在 SDK 中是一个普通字符串（ChatModel 是 string 的别名），因此任何模型 id 都可以工作，而不仅仅是 README 中显示的常量。
• openai.UserMessage(...) 是一个用户轮次。README 示例使用 DeveloperMessage 和一个 GPT 常量；这里一个用户消息和一个字符串 id 就足够了。

读取答案、finish_reason 和 usage#

这三者都来自 SDK 已经为你解析的字段：

• resp.Choices[0].Message.Content 是文本（一个 string）。
• resp.Choices[0].FinishReason 也是一个 string。stop 表示模型自行完成；length 表示答案达到 token 限制并被截断。如果你看到 length，请阅读 为什么答案在句子中间停止。
• resp.Usage 包含 PromptTokens（你发送的内容）、CompletionTokens（模型写的内容）和 TotalTokens，都是 int64。

输出将如下所示：答案，然后是带值的 finish_reason:，然后是三个 token 计数。每次运行的数字都不同，所以记录它们。它们是你付费的内容，而输出 token 是更昂贵的一侧。

重试和超时：三个不同的限制#

这是 Go 服务通常受到伤害的地方：默认情况下 SDK 根本没有超时，因此停滞的连接可以永远等待。三个设置可以解决这个问题，它们在不同级别工作：

• option.WithMaxRetries(2)：SDK 以短暂的指数等待重试连接错误、408、409、429 和 5xx。两次重试已经是默认值；0 关闭重试。你可以在客户端上设置，也可以在单次调用上设置。
• option.WithRequestTimeout(30*time.Second)：单次尝试的限制。
• context 截止时间：整个调用的限制，包括重试和等待。

因此，有 2 次重试时，最多可能有 3 次尝试：最坏情况下等待 3 × 30 = 90 秒，加上尝试之间的短暂停顿。两分钟的上下文可以覆盖这一点。如果你想要一个 Web 处理程序的硬性规则“20 秒内回答”，请缩短上下文，而不仅仅是每次尝试的超时。

关于选择这些数字的更长背景，相同建议的 Python 版本在 OpenAI Python SDK 超时和重试 中。逻辑可以沿用到 Go。

一千次这样的调用要花多少钱#

假设你运行一个小服务，每天发出 1,000 个请求，每个请求大约有 800 个输入 token 和 300 个输出 token。在 deepseek-ai/DeepSeek-V4-Flash-0731 上，那天的费用是 $0.042（1,000 × 800 输入 token，1,000 × 300 输出 token）。表格显示了我们的模型上的相同负载；按总量计算，输入和输出加在一起，它比 OpenRouter 更便宜。

填入你自己的数字。你的第一次运行会打印真实的 PromptTokens 和 CompletionTokens，因此你不必猜测平均值：

定价页面 和 模型页面 上的价格是实时的，每个模型使用一个固定价格，没有高峰时段。

如果它不工作#

• 错误提到 401： 密钥为空或错误。os.Getenv 对未设置的变量返回空字符串，因此在运行 go run . 的同一终端中检查 echo $CHEAPTOKENS_API_KEY。
• 错误提到 404 或未知模型： id。完整复制它，带有 deepseek-ai/ 前缀。你可以在 模型列表调用 中列出 id。
• go: module requires Go 1.26： 你的工具链较旧。如顶部所示固定一个较旧的 SDK 标签。
• 调用挂起然后失败： 那是超时在起作用。先检查网络路径，然后如果模型确实需要更多时间来完成长答案，请提高 WithRequestTimeout。

如果 base URL 概念对你来说是新的，什么是 base_url 以及如何切换 无需代码即可解释。