Gemini API 程式庫¶
使用 Gemini API 進行開發時,我們建議使用 Google GenAI SDK。 這些是我們為最受歡迎的程式語言開發與維護的官方程式庫,已可供正式環境使用。 目前處於正式推出階段,我們所有官方 文件與範例皆使用這些程式庫。
注意:如果您使用的是舊版程式庫,我們強烈建議您 遷移至 Google GenAI SDK。請參閱 舊版程式庫一節以瞭解更多 資訊。如果您使用 AI 程式設計助理,請安裝 Gemini API 開發技能,讓您的 代理能存取最新文件與最佳做法。
如果您是 Gemini API 的新手,請依照我們的開始使用指南入門。
語言支援與安裝¶
Google GenAI SDK 提供 Python、JavaScript/TypeScript、Go 與 Java 等語言版本。您可以透過套件管理工具安裝各語言的程式庫, 或造訪各自的 GitHub 存放區進一步參與:
-
程式庫:
google-genai -
GitHub 存放區:googleapis/python-genai
-
安裝方式:
pip install google-genai
-
程式庫:
@google/genai -
GitHub 存放區:googleapis/js-genai
-
安裝方式:
npm install @google/genai
-
GitHub 存放區:googleapis/go-genai
-
安裝方式:
go get google.golang.org/genai
-
程式庫:
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>
-
程式庫:
Google.GenAI -
GitHub 存放區:googleapis/dotnet-genai
-
安裝方式:
dotnet add package Google.GenAI
正式推出¶
截至 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 and 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 程式庫遷移。您可以直接從 語言支援與安裝一節的新程式庫開始使用。