使用 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-genai
GitHub 代码库:googleapis/java-genai
安装:如果您使用的是 Maven,请将以下代码添加到您的依赖项中:
<dependencies>
<dependency>
<groupId>com.google.genai</groupId>
<artifactId>google-genai</artifactId>
<version>1.0.0</version>
</dependency>
</dependencies>
正式版
我们于 2024 年末开始推出 Google GenAI SDK。 截至 2025 年 5 月,该功能已在所有受支持的平台上正式发布 (GA)。这意味着这些库稳定可靠,完全支持在生产环境中使用。它们会定期维护,可提供对最新功能的访问权限,并且在与 Gemini 搭配使用时可提供最佳性能。
如果您未使用 Google GenAI SDK,而是使用我们的某个旧版库,我们强烈建议您进行迁移。 如需了解详情,请参阅旧版库部分。
旧版库和迁移
如果您使用的是我们的某个旧版库,建议您迁移到新库。
旧版库无法提供对最新功能(例如 Live API 和 Veo)的访问权限,并且正处于弃用阶段。这些设备将于 2025 年 9 月底停止接收更新,功能差距会越来越大,潜在的 bug 可能不再得到修复。
每个旧版库的支持状态各不相同,详见下表:
语言 | 旧版库 | 支持情况 | 推荐的库 |
---|---|---|---|
Python | google-generativeai |
所有支持(包括 bug 修复)将于 2025 年 9 月底结束。 | google-genai |
JavaScript/TypeScript | @google/generativeai |
所有支持(包括 bug 修复)将于 2025 年 9 月底结束。 | @google/genai |
Go | google.golang.org/generative-ai |
所有支持(包括 bug 修复)将于 2025 年 9 月底结束。 | google.golang.org/genai |
Dart 和 Flutter | google_generative_ai |
未积极维护 | 使用受信任的社区或第三方库(例如 firebase_ai),或使用 REST API 进行访问 |
Swift | generative-ai-swift |
未积极维护 | 使用 Gemini in Firebase |
Android | generative-ai-android |
未积极维护 | 使用 Gemini in Firebase |
面向 Java 开发者的注意事项:Google 之前并未提供适用于 Gemini API 的旧版 Java SDK,因此无需从之前的 Google 库进行迁移。您可以直接从语言支持和安装部分开始使用新库。