go-openai

环境要求

• Go 1.18 或更高版本
• 已安装 Go 工具链（可用 go 命令）
• 一个有效的 OpenAI API Key（platform.openai.com 获取）
• 能访问 OpenAI API 的网络环境

安装与启动步骤

1. 1检查 Go 版本

   README 要求 Go 1.18 或更高，先确认本机 Go 版本满足条件，过低需先升级。

   go version

   复制

2. 2安装客户端库

   在项目目录执行 go get 拉取 go-openai 依赖，会自动写入 go.mod。

   go get github.com/sashabaranov/go-openai

   复制

3. 3设置 API Key

   把从 OpenAI 平台申请的密钥写入环境变量 OPENAI_API_KEY，供程序读取。

   export OPENAI_API_KEY="sk-xxxxxxxx"

   复制

4. 4编写示例代码

   新建 main.go，粘贴 README 的 Responses API 示例，用环境变量构造客户端。

   package main
   
   import (
   	"context"
   	"fmt"
   	"log"
   	"os"
   
   	openai "github.com/sashabaranov/go-openai"
   )
   
   func main() {
   	client := openai.NewClient(os.Getenv("OPENAI_API_KEY"))
   
   	response, err := client.CreateResponse(context.Background(), openai.CreateResponseRequest{
   		Model:        openai.GPT5Dot6Sol,
   		Instructions: "You are a concise technical explainer.",
   		Input:        "Why is the sky blue?",
   	})
   	if err != nil {
   		log.Fatal(err)
   	}
   
   	fmt.Println(response.GetOutputText())
   }

   复制

5. 5运行程序

   执行 go run 运行示例，成功时终端会打印模型返回的文本。

   go run main.go

   复制

关键配置

如何确认成功

程序运行后在终端输出模型生成的回答文本，且没有 log.Fatal 抛出的报错信息。

常见问题

注意事项

• 这是非官方 Go 客户端库，不是可独立运行的服务，需要写代码集成。
• API Key 不要硬编码进源码或提交到仓库，建议用环境变量传入。
• README 明确要求 Go 1.18+，版本过低会导致编译失败。