Gemini API SDK 与库
使用 Gemini API 构建时,我们建议使用 Google GenAI SDK。这些是我们为最流行的语言开发和维护的官方生产就绪库。他们在 一般可用性 并在我们所有的官方文档和示例中使用。
如果您是 Gemini API 的新手,请按照我们的 入门指南 开始吧。
语言支持和安装 #
Google GenAI SDK 可用于 Python、JavaScript/TypeScript、Go 和 Java 语言。您可以使用包管理器安装每种语言的库,或访问他们的 GitHub 存储库以进一步参与:
图书馆:
google-genaiGitHub 存储库: googleapis/python-genai
安装:
pip install google-genai
图书馆:
@google/genaiGitHub 存储库: googleapis/js-genai
安装:
npm install @google/genai
GitHub 存储库: googleapis/go-genai
安装:
go get google.golang.org/genai
图书馆:
google-genaiGitHub 存储库: googleapis/java-genai
安装:如果您使用 Maven,请将以下内容添加到您的依赖项中:
<dependencies>
<dependency>
<groupId>com.google.genai</groupId>
<artifactId>google-genai</artifactId>
<version>1.0.0</version>
</dependency>
</dependencies>
图书馆:
Google.GenAIGitHub 存储库: googleapis/dotnet-genai
安装:
dotnet add package Google.GenAI
一般可用性 #
截至 5 月,2025, 和 Google GenAI SDK 已在所有支持的平台上全面上市 (GA),并且是访问 Gemini API 的推荐库。它们很稳定,完全支持生产使用,并且得到积极维护。它们提供对最新功能的访问,并提供与 Gemini 配合使用的最佳性能。
如果您正在使用我们的旧库之一,我们强烈建议您进行迁移,以便您可以访问最新功能并在使用 Gemini 时获得最佳性能。回顾 遗留库 部分了解更多信息。
遗留库和迁移 #
如果您正在使用我们的旧库之一,我们建议您 迁移到新库.
遗留库不提供对最新功能的访问(例如 Live API 和 Veo)并于 11 月 30 日起弃用,2025.
每个旧库的支持状态各不相同,详细信息如下表所示:
| 语言 | 遗留库 | 支持状态 | 推荐库 |
|---|---|---|---|
| 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人工智能逻辑 |
| 斯威夫特 | generative-ai-swift | 没有积极维护 | 使用 Firebase人工智能逻辑 |
| 安卓 | generative-ai-android | 没有积极维护 | 使用 Firebase人工智能逻辑 |
Java 开发人员注意事项: Google 没有为 Gemini API 提供旧版 Java SDK,因此不需要从以前的 Google 库进行迁移。您可以直接从新库开始 语言支持和安装 部分。