# Gemini API SDK 与库

使用 Gemini API 构建时，我们建议使用 **Google GenAI SDK**。这些是我们为最流行的语言开发和维护的官方生产就绪库。他们在 [一般可用性](/docs/libraries#new-libraries) 并在我们所有的官方文档和示例中使用。

{% callout type="note" %}
注意：如果您正在使用我们的旧库之一，我们强烈建议您 [迁移](/docs/migrate) 到 Google GenAI SDK。回顾 [遗留库](/docs/libraries#previous-sdks) 部分了解更多信息。如果您使用 AI 编码助手，请安装 [Gemini API开发技巧](/docs/coding-agents) 让您的智能体访问最新文档和最佳实践。
{% /callout %}

如果您是 Gemini API 的新手，请按照我们的 [入门指南](/docs/get-started) 开始吧。

## 语言支持和安装  {% #install %}

Google GenAI SDK 可用于 Python、JavaScript/TypeScript、Go 和 Java 语言。您可以使用包管理器安装每种语言的库，或访问他们的 GitHub 存储库以进一步参与：

{% tabs %}
{% tab label="Python" %}
* 图书馆： [`google-genai`](https://pypi.org/project/google-genai)

* GitHub 存储库： [googleapis/python-genai](https://github.com/googleapis/python-genai)

* 安装： `pip install google-genai`
{% /tab %}

{% tab label="JavaScript" %}
* 图书馆： [`@google/genai`](https://www.npmjs.com/package/@google/genai)

* GitHub 存储库： [googleapis/js-genai](https://github.com/googleapis/js-genai)

* 安装： `npm install @google/genai`
{% /tab %}

{% tab label="Go" %}
* 图书馆： [`google.golang.org/genai`](https://pkg.go.dev/google.golang.org/genai)

* GitHub 存储库： [googleapis/go-genai](https://github.com/googleapis/go-genai)

* 安装： `go get google.golang.org/genai`
{% /tab %}

{% tab label="Java" %}
* 图书馆： `google-genai`

* GitHub 存储库： [googleapis/java-genai](https://github.com/googleapis/java-genai)

* 安装：如果您使用 Maven，请将以下内容添加到您的依赖项中：

```xml
<dependencies>
  <dependency>
    <groupId>com.google.genai</groupId>
    <artifactId>google-genai</artifactId>
    <version>1.0.0</version>
  </dependency>
</dependencies>
```
{% /tab %}

{% tab label="C# (.NET)" %}
* 图书馆： `Google.GenAI`

* GitHub 存储库： [googleapis/dotnet-genai](https://googleapis.github.io/dotnet-genai/)

* 安装： `dotnet add package Google.GenAI`
{% /tab %}
{% /tabs %}

## 一般可用性  {% #new-libraries %}

截至 5 月，2025, 和 Google GenAI SDK 已在所有支持的平台上全面上市 (GA)，并且是访问 Gemini API 的推荐库。它们很稳定，完全支持生产使用，并且得到积极维护。它们提供对最新功能的访问，并提供与 Gemini 配合使用的最佳性能。

如果您正在使用我们的旧库之一，我们强烈建议您进行迁移，以便您可以访问最新功能并在使用 Gemini 时获得最佳性能。回顾 [遗留库](/docs/libraries#previous-sdks) 部分了解更多信息。

## 遗留库和迁移  {% #previous-sdks %}

如果您正在使用我们的旧库之一，我们建议您 [迁移到新库](/docs/migrate).

遗留库不提供对最新功能的访问（例如 [Live API](/docs/live-api) 和 [Veo](/docs/video)）并于 11 月 30 日起弃用，2025.

每个旧库的支持状态各不相同，详细信息如下表所示：

| 语言                        | 遗留库                                                                                       | 支持状态   | 推荐库                                                                                                            |
| ------------------------- | ----------------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------- |
| **Python**                | [`google-generativeai`](https://github.com/google-gemini/deprecated-generative-ai-python) | 没有积极维护 | [`google-genai`](https://github.com/googleapis/python-genai)                                                   |
| **JavaScript/TypeScript** | [`@google/generativeai`](https://github.com/google-gemini/generative-ai-js)               | 没有积极维护 | [`@google/genai`](https://github.com/googleapis/js-genai)                                                      |
| **Go**                    | [`google.golang.org/generative-ai`](https://github.com/google/generative-ai-go)           | 没有积极维护 | [`google.golang.org/genai`](https://github.com/googleapis/go-genai)                                            |
| **Dart 和 Flutter**        | [`google_generative_ai`](https://pub.dev/packages/google_generative_ai/install)           | 没有积极维护 | 使用 [元吉特飞镖](https://genkit.dev/docs/dart/get-started/) 或 [Firebase人工智能逻辑](https://pub.dev/packages/firebase_ai) |
| **斯威夫特**                  | [`generative-ai-swift`](https://github.com/google/generative-ai-swift)                    | 没有积极维护 | 使用 [Firebase人工智能逻辑](https://firebase.google.com/products/firebase-ai-logic)                                    |
| **安卓**                    | [`generative-ai-android`](https://github.com/google-gemini/generative-ai-android)         | 没有积极维护 | 使用 [Firebase人工智能逻辑](https://firebase.google.com/products/firebase-ai-logic)                                    |

**Java 开发人员注意事项：** Google 没有为 Gemini API 提供旧版 Java SDK，因此不需要从以前的 Google 库进行迁移。您可以直接从新库开始 [语言支持和安装](/docs/libraries#install) 部分。
