googleapis/js-genai

TypeScript 與 JavaScript 的 Google Gen AI SDK

是什麼 – 由 Google 官方提供的客戶端程式庫（@google/genai），讓 JavaScript/TypeScript 程式碼可呼叫 Gemini 系列的大語言模型。支援透過 API 金鑰存取公開的 Gemini Developer API，也支援透過 Google Cloud 憑證存取 Gemini Enterprise Agent Platform。

核心功能

• 模型呼叫 – generateContent、generateContentStream、generateImages、generateVideos 等
• 具狀態的聊天 – ai.chats 物件可保存對話歷史，支援多輪互動。
• 快取 – ai.caches 允許將大型提示前置詞儲存在伺服器上，以降低 token 成本。
• 檔案處理 – ai.files 可上傳大檔案（影像、音訊、PDF），並在提示中引用。
• 即時會話 – ai.live 支援即時文字/音訊/影片互動。
• 函式呼叫 / 工具 – 可宣告函式或使用內建工具（Google 搜尋、程式碼執行、Model Context Protocol），讓 Gemini 自動呼叫。
• 互動 API – 高階封裝（ai.interactions），可管理狀態、工具編排及長時間執行任務（如深度研究代理）。

典型用法

import {GoogleGenAI} from '@google/genai';
const ai = new GoogleGenAI({apiKey: process.env.GEMINI_API_KEY});
const resp = await ai.models.generateContent({
  model: 'gemini-2.5-flash',
  contents: '為什麼天空是藍色的？'
});
console.log(resp.text);

同一類別在 Node、瀏覽器或企業環境中均可使用，只需傳入 enterprise: true 並提供專案與位置資訊。

安裝 – npm install @google/genai（需 Node 20+，後續版本需 Node 22+）。

文件與範例 – 完整 API 參考文件見 https://googleapis.github.io/js-genai/，倉儲中的 sdk-samples 檔案夾包含可執行的範例集合。

為何重要 – 它為開發者提供了一種單一、最新、便捷的方式，存取 Google 最新的 Gemini 2.0+ 功能（多模態輸入、串流傳輸、自動函式呼叫、MCP 等），無需處理原始 HTTP 呼叫或舊版 SDK。