Gemini API 程式庫

本頁面提供 Gemini API 最新程式庫的下載和安裝資訊。如果您是 Gemini API 新手,請先參閱 API 快速入門指南

關於新程式庫的重要注意事項

我們最近推出一組新程式庫,可在不同 Google 服務中提供更一致且流暢的體驗,讓您存取 Google 的生成式 AI 模型。

重點程式庫更新

語言 舊程式庫 新資料庫 (建議)
Python google-generativeai google-genai
JavaScript
和 TypeScript
@google/generative-ai @google/genai
目前為預先發布版
Go google.golang.org/generative-ai google.golang.org/genai

我們強烈建議先前程式庫的所有使用者遷移至新程式庫。雖然 JavaScript/TypeScript 程式庫仍處於預覽階段,但只要您能接受「JavaScript/TypeScript」一節列出的注意事項,我們仍建議您開始遷移。

Python

您可以執行以下命令來安裝 Python 程式庫

pip install google-genai

JavaScript 和 TypeScript

您可以執行以下命令來安裝 JavaScript 和 TypeScript 程式庫

npm install @google/genai

JavaScript/TypeScript 程式庫目前處於搶先體驗階段,也就是說,程式庫可能尚未完成所有功能,且我們可能需要引入重大變更。

不過,只要您能接受這些注意事項,我們強烈建議您開始使用新版 SDK,而非舊版 (已淘汰的版本)。我們正在積極為此程式庫推出 GA (General Availability) 版本。

用戶端應用程式中的 API 金鑰

警告:無論您使用哪個程式庫,將 API 金鑰插入用戶端 JavaScript 或 TypeScript 程式碼中都是不安全的做法。使用伺服器端部署作業,在實際工作環境中存取 Gemini API。

Go

您可以執行以下指令來安裝 Go 程式庫

go get google.golang.org/genai

舊版程式庫和 SDK

以下是我們不再積極開發的舊版 SDK 組合,您可以參考遷移指南,改用更新版的 Google Gen AI SDK: