go-genai

环境要求

• 本地已安装 Go 工具链（需支持 go get 与 Go modules）
• 已有一个 Go module 项目（含 go.mod）
• 网络可访问 Go 模块代理（如 proxy.golang.org）

安装与启动步骤

1. 1初始化 Go 模块

   若项目还没有 go.mod，先在项目根目录初始化模块，模块名可自定义。已有 go.mod 则跳过。

   go mod init example.com/demo

   复制

2. 2安装 SDK 依赖

   README 给出的唯一安装命令，把 SDK 加入当前模块依赖并写入 go.mod。

   go get google.golang.org/genai

   复制

3. 3在代码中导入包

   在 Go 源文件中导入 SDK 包，路径与安装时一致，包名为 genai。

   import "google.golang.org/genai"

   复制

4. 4调用模型生成内容

   按 README 示例构造 Parts，调用 client.Models.GenerateContent 传入模型名与内容。

   parts := []*genai.Part{
     {Text: "What's this image about?"},
     {InlineData: &genai.Blob{Data: imageBytes, MIMEType: "image/jpeg"}},
   }
   result, err := client.Models.GenerateContent(ctx, "gemini-flash-latest", []*genai.Content{{Parts: parts}}, nil)

   复制

5. 5固定 SDK 版本

   README 建议固定版本，避免 GenerateVideos 等接口后续不兼容更新带来意外影响。

6. 6编译验证集成

   执行构建确认依赖可正常下载与编译通过，无未解析的 import。

   go build ./...

   复制

关键配置

如何确认成功

执行 go build ./... 无报错，说明 SDK 已成功引入并可编译；实际生成结果需运行代码查看返回。

常见问题

注意事项

• README 未给出 API Key 配置与客户端 client 创建方式的说明，需查阅 pkg.go.dev 上的完整文档。
• 示例中的模型名 gemini-flash-latest 来自 README 代码片段，可按需替换。
• Go 最低版本要求 README 未明确，建议使用较新的稳定版 Go 工具链。
• 生产项目建议在 go.mod 中固定版本（< 2.0.0）后再长期使用。