openai-go

官方 Go SDK，类型安全调用 OpenAI 接口

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开发框架 🍴 复刻 357 🐛 待处理 103 👀 关注 30

GitHub ↗

GitHub 星标 ★ 3505

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，调用 OpenAI API 需按量付费

项目预览

项目数据

分类开发框架

开发团队openai

GitHubhttps://github.com/openai/openai-go

定价模式🏷️完全免费

价格说明开源免费，调用 OpenAI API 需按量付费

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Go

GitHub 星标★ 3505

上线时间2024-07-22 00:00:00

代码更新2026-10-23

仓库体积17.6 MB

本站数据更新2026-10-26

维护状态活跃

收录时间2026-10-26

浏览次数0

项目介绍

openai-go 是 OpenAI 官方维护的 Go 语言 SDK，用于在 Go 服务中调用 OpenAI API。它解决的是 Go 开发者需要自行封装 HTTP 请求、鉴权、重试、流式响应和错误处理的问题。核心能力包括：覆盖 Chat Completions、Responses、Embeddings、Images、Audio、Files、Batch 等接口的类型化客户端；内置请求参数与响应结构体，减少手写 JSON 映射；支持流式输出（SSE）与上下文取消；提供可配置的 HTTP Client、超时、重试与中间件机制；统一的 APIError 错误类型便于分类处理。项目由官方维护，接口随平台更新同步，适合构建聊天机器人、内容生成、语义检索、批量推理等后端服务。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-10-26 · 当前星标 ★ 3505

使用教程

难度：入门约 10 分钟部署方式：库/依赖 5 步

环境要求

Go 1.26 或更高版本，建议使用 1.26.9 / 1.27.2 及以上的补丁版本
需要能够调用 OpenAI API 的网络环境
准备一个 OpenAI API Key，SDK 默认读取环境变量 OPENAI_API_KEY

安装与启动步骤

1确认 Go 版本

先确认本机 Go 版本，低于 1.26 需先升级工具链，否则无法使用最新 SDK。
```
go version
```
2安装 SDK 依赖

在项目模块中拉取 v3.86.0，README 建议固定版本以免自动升级引入变更。
```
go get -u 'github.com/openai/openai-go/v3@v3.86.0'
```
3设置 API Key

把密钥写入环境变量，代码未显式传参时客户端会读取该变量。
```
export OPENAI_API_KEY="sk-xxxxxxxx"
```

4编写示例程序

新建 main.go，导入 /v3 包，用 Responses.New 发送一句话并打印返回文本。

package main

import (
	"context"

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

func main() {
	ctx := context.Background()
	client := openai.NewClient(
		option.WithAPIKey("sk-xxxxxxxx"), // defaults to os.LookupEnv("OPENAI_API_KEY")
	)

	question := "Write me a haiku about computers"

	resp, err := client.Responses.New(ctx, responses.ResponseNewParams{
		Input: responses.ResponseNewParamsInputUnion{OfString: openai.String(question)},
		Model: openai.ChatModelGPT5_2,
	})

	if err != nil {
		panic(err)
	}

	println(resp.OutputText())
}

5运行示例

在包含 main.go 的模块目录执行，首次运行会自动下载依赖并编译。
```
go run main.go
```

关键配置

配置项	必填	说明	示例
`OPENAI_API_KEY`	是	OpenAI API 密钥，客户端默认从该环境变量读取	`sk-xxxxxxxx`
`Model`	是	请求参数中的模型常量，示例使用 GPT-5.2 对应常量	`openai.ChatModelGPT5_2`