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 的建議程式庫。這些 API 穩定可靠，可完全支援用於正式環境，且會主動維護。這些版本提供最新功能，並與 Gemini 搭配運作，可發揮最佳效能。

如果您使用舊版程式庫，強烈建議您遷移，以便存取最新功能，並在搭配 Gemini 使用時獲得最佳效能。詳情請參閱「舊版程式庫」一節。

舊版程式庫和遷移作業

如果您使用舊版程式庫，建議遷移至新版程式庫。

舊版程式庫無法存取最新功能 (例如 Live API 和 Veo)，且已進入淘汰程序。這些裝置將於 2025 年 9 月底停止接收更新，屆時功能差距會越來越大，潛在錯誤也可能不再修正。

各個舊版程式庫的支援狀態不盡相同，詳情請參閱下表：

語言 舊版程式庫 支援狀態 建議的程式庫
Python google-generativeai 包括修正錯誤在內的所有支援服務，將於 2025 年 9 月底終止。 google-genai
JavaScript/TypeScript @google/generativeai 包括修正錯誤在內的所有支援服務，將於 2025 年 9 月底終止。 @google/genai
Go google.golang.org/generative-ai 包括修正錯誤在內的所有支援服務，將於 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 產生程式碼，這是因為訓練資料的截斷日期所致。如要讓產生的程式碼使用最新且建議的程式庫，請直接在提示中提供版本和使用方式指引。您可以使用下列範本提供必要背景資訊：