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>

C#

正式版

截至 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 不会积极维护 使用 Genkit Dart 或 Firebase AI Logic
Swift generative-ai-swift 不会积极维护 使用 Firebase AI Logic
Android generative-ai-android 不会积极维护 使用 Firebase AI Logic

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