[已弃用] 适用于 Gemini API 的 Google AI Go SDK

随着 Gemini 2.0 的发布，我们抓住机会为所有希望使用 Google GenAI 模型（Gemini、Veo、Imagen 等）的开发者打造了一个统一的 SDK。在此过程中，我们综合了来自本 SDK 的反馈，以及开发者对生态系统中其他 SDK 的好评，从而创建了 Google Gen AI SDK。

Gemini API 文档已全面更新，展示了新版 Google Gen AI SDK 的示例：快速入门。

我们深知 SDK 更改可能带来的影响，并不会轻率做出这一决定。然而，我们的目标是为开发者构建与我们的模型集成的应用程序提供一条极其简单明了的路径，因此我们认为进行此次更改十分必要。

感谢您使用 Gemini 进行开发！如果您需要任何帮助，请随时告诉我们：点击这里。

请注意，此代码仓库现已被视为遗留项目。 为了获得最新功能、性能优化及持续的开发支持，我们强烈建议您迁移到官方的 Google Generative AI SDK for Go。

本仓库的支持计划：

• 有限维护： 目前仅限于修复关键性缺陷，不再添加新功能。
• 目的： 此有限支持旨在为用户提供稳定性保障，以便顺利完成向新 SDK 的迁移。
• 终止支持日期： 本仓库的所有支持工作（包括缺陷修复）将于 2025年11月30日 彻底停止。

我们鼓励所有用户尽早规划向 Google Generative AI SDK 的迁移，以确保能够持续使用最新的功能并获得相应的技术支持。

generative-ai-go 快速上手指南

⚠️ 重要提示：本项目已弃用（Deprecated）

随着 Gemini 2.0 的发布，Google 推出了统一的 Google Gen AI SDK。

• 本仓库 (generative-ai-go) 仅进行关键漏洞修复，不再添加新功能。
• 停止支持日期：2025 年 11 月 30 日。
• 强烈建议：新开发项目或现有项目迁移请直接使用官方新版 SDK (go-genai)。

以下指南仅供维护旧代码参考。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS, 或 Windows
• Go 版本：Go 1.21 或更高版本
• 依赖项：
  • 已初始化的 Go 模块 (go mod init)
  • 有效的 Google Cloud API Key (需启用 Gemini API)

安装步骤

由于网络原因，国内开发者建议使用 GOPROXY 加速依赖下载。

1. 配置国内镜像源（可选但推荐）：

   export GOPROXY=https://goproxy.cn,direct
   

2. 安装旧版 SDK： 在项目目录下运行以下命令安装此弃用版本的库：

   go get github.com/google/generative-ai-go
   

基本使用

以下是最简单的文本生成示例。请注意，实际生产中应使用新版 SDK。

package main

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

	"github.com/google/generative-ai-go/genai"
	"google.golang.org/api/option"
)

func main() {
	ctx := context.Background()

	// 从环境变量获取 API Key
	apiKey := os.Getenv("GEMINI_API_KEY")
	if apiKey == "" {
		log.Fatal("请设置 GEMINI_API_KEY 环境变量")
	}

	// 初始化客户端
	client, err := genai.NewClient(ctx, option.WithAPIKey(apiKey))
	if err != nil {
		log.Fatal(err)
	}
	defer client.Close()

	// 选择模型
	model := client.GenerativeModel("gemini-pro")

	// 生成内容
	resp, err := model.GenerateContent(ctx, genai.Text("你好，请简单介绍一下你自己。"))
	if err != nil {
		log.Fatal(err)
	}

	// 输出结果
	for _, candidate := range resp.Candidates {
		for _, part := range candidate.Content.Parts {
			fmt.Println(part)
		}
	}
}

下一步行动：请尽快查阅 Google Gen AI SDK for Go 文档以完成迁移，确保持续获得最新功能和安全支持。