Gemini API 库

使用 Gemini API 进行构建时，我们建议使用 Google GenAI SDK。这些是我们为最热门的语言开发和维护的正式版库，可用于生产环境。它们处于正式版阶段，并已用于我们的所有官方文档和示例中。

如果您是 Gemini API 新手，请按照我们的快速入门指南开始使用。

语言支持和安装

Google GenAI SDK 有 Python、JavaScript/TypeScript、Go 和 Java 语言版本。您可以使用软件包管理器安装每种语言的库，也可以访问其 GitHub 代码库以进行进一步互动：

Python

JavaScript

Go

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 年底推出 Gemini 2.0 时，开始推出 Google GenAI SDK，这是一组用于访问 Gemini API 的新库。

截至 2025 年 5 月，这些库已在所有受支持的平台上发布正式版 (GA)，是访问 Gemini API 的推荐库。它们稳定可靠，完全支持生产用途，并且会积极维护。它们可提供对最新功能的访问权限，并可在与 Gemini 搭配使用时提供最佳性能。

如果您使用的是我们的某个旧版库，我们强烈建议您进行迁移，以便使用最新功能并获得最佳性能，从而更好地使用 Gemini。 如需了解详情，请参阅旧版库部分。

旧版库和迁移

如果您使用的是我们的某个旧版库，建议您迁移到新库。

旧版库无法提供对最新功能（例如 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 未积极维护 使用 Firebase AI Logic
Android generative-ai-android 未积极维护 使用 Firebase AI Logic

面向 Java 开发者的注意事项：Google 之前并未提供旧版 Gemini API Java SDK，因此无需从之前的 Google 库进行迁移。您可以直接从语言支持和安装部分开始使用新库。

用于生成代码的提示模板

生成模型（例如Gemini、Claude）和 AI 赋能的 IDE（例如 Cursor）可能会因训练数据截止日期而使用过时或已弃用的库生成 Gemini API 的代码。为了让生成的代码使用最新且推荐的库，请直接在提示中提供版本和使用指南。您可以使用以下模板提供必要的背景信息：