使用 Gemini API 进行构建时,我们建议使用 Google GenAI SDK。 这些是官方的、可用于生产环境的库,由我们针对最热门的语言开发和维护。它们处于正式版阶段,并已用于我们的所有官方文档和示例中。
如果您是 Gemini API 新手,请按照我们的快速入门指南开始使用。
语言支持和安装
Google GenAI SDK 适用于 Python、JavaScript/TypeScript、Go 和 Java 语言。您可以使用软件包管理器安装每种语言的库,也可以访问其 GitHub 代码库以进行进一步互动:
Python
GitHub 代码库:googleapis/python-genai
安装:
pip install google-genai
JavaScript
GitHub 代码库:googleapis/js-genai
安装:
npm install @google/genai
Go
GitHub 代码库:googleapis/go-genai
安装:
go get google.golang.org/genai
Java
库:
google-genaiGitHub 代码库:googleapis/java-genai
安装:如果您使用的是 Maven,请将以下代码添加到您的依赖项中:
<dependencies>
<dependency>
<groupId>com.google.genai</groupId>
<artifactId>google-genai</artifactId>
<version>1.0.0</version>
</dependency>
</dependencies>
C#
库:
Google.GenAIGitHub 代码库:googleapis/dotnet-genai
安装:
dotnet add package Google.GenAI
正式版
截至 2025 年 5 月,Google GenAI SDK 已在所有受支持的平台上正式发布 (GA),是访问 Gemini API 的推荐库。 它们稳定可靠,在生产环境中完全受支持,并且会积极维护。 它们可提供对最新功能的访问权限,并能与 Gemini 搭配使用,提供最佳性能。
如果您使用的是我们的旧版库,我们强烈建议您进行迁移,以便使用最新功能并获得最佳的 Gemini 性能。如需了解详情,请参阅旧版库部分。
旧版库和迁移
如果您使用的是我们的某个旧版库,建议您迁移到新库。
旧版库无法访问最新功能(例如 Live API 和 Veo),并且已于 2025 年 11 月 30 日弃用。
每个旧版库的支持状态各不相同,详见下表:
| 语言 | 旧版库 | 支持情况 | 推荐的库 |
|---|---|---|---|
| Python | google-generativeai |
未积极维护 | google-genai |
| JavaScript/TypeScript | @google/generativeai |
未积极维护 | @google/genai |
| Go | google.golang.org/generative-ai |
未积极维护 | google.golang.org/genai |
| Dart 和 Flutter | google_generative_ai |
未积极维护 | 使用受信任的社区或第三方库(例如 firebase_ai),或使用 REST API 进行访问 |
| Swift | generative-ai-swift |
未积极维护 | 使用 Firebase AI Logic |
| Android | generative-ai-android |
未积极维护 | 使用 Firebase AI Logic |
面向 Java 开发者的注意事项:Google 之前并未提供旧版 Gemini API Java SDK,因此无需从之前的 Google 库进行迁移。您可以直接从语言支持和安装部分开始使用新库。
用于生成代码的提示模板
生成模型(例如,Gemini、Claude)和 AI 赋能的 IDE(例如 Cursor) 可能会因训练数据截止日期而使用过时或已弃用的库生成 Gemini API 的代码。为了让生成的代码使用最新且推荐的库,请直接在提示中提供版本和使用指南。您可以使用以下模板提供必要的背景信息: