Gemini API 程式庫

使用 Gemini API 建構時，建議使用 Google GenAI SDK。這些是我們針對最熱門語言開發及維護的官方正式版程式庫。這些 API 已正式發布，並用於所有官方說明文件和範例。

如果您是第一次使用 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 的建議程式庫。這些 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 開發人員注意事項：Google 未提供 Gemini API 的舊版 Java SDK，因此不需要從先前的 Google 程式庫遷移。您可以直接在「語言支援和安裝」一節中開始使用新程式庫。