Interactions API：我們針對 Gemini 模型與 Agent 的主要介面

今天我們宣布 Interactions API 已達到正式發佈 (GA) 階段，並成為我們與 Gemini 模型和 Agent 互動的主要 API。我們在 2025 年 12 月 推出了其公開測試版，它迅速成為開發者使用 Gemini 建構應用程式的首選方式。

在此 GA 版本中，API 現在擁有穩定的架構，我們還新增了開發者要求的重大功能，包括 Managed Agents、背景執行、Gemini Omni（即將推出）等。我們所有的文件現在預設使用 Interactions API，並正在與生態系統合作夥伴合作，使其成為第三方 SDK 和函式庫的預設介面。

使用 Gemini 最簡單的方式

無論你是呼叫模型還是執行 Agent，Interactions API 只需幾行程式碼就能達成。傳入模型 ID 進行推理，或傳入 Agent ID 執行自主任務，並為長時間運行的任務設定 background=True。

1from google import genai
2
3client = genai.Client()
4
5# 與模型對話
6interaction = client.interactions.create(
7    model="gemini-3.5-flash",
8    input="簡單解釋量子糾纏。",
9)
10
11# 執行 Agent
12interaction = client.interactions.create(
13    agent="antigravity-preview-05-2026",
14    input="繪製全球太陽能發電量的增長，並製作一些 HTML 投影片。",
15    environment="remote",
16)

自 12 月以來的重大更新

• Managed Agents：單一 API 呼叫即可佈建一個遠端 Linux 沙盒，Agent 可在此進行推理、執行程式碼、瀏覽網路及管理檔案。Antigravity agent 是預設的 Agent，你也可以使用指令、技能和資料來源定義自己的自訂 Agent。
• 背景執行：在任何呼叫上設定 background=True。伺服器會非同步執行互動。
• 工具改進：在單一請求中混合使用內建工具（如 Google Search、Google Maps）與你自己的函式。工具結果現在可以同時傳回圖片與文字。
• Deep Research 升級：兩種新的 Agent 版本（速度 vs. 深度）、協作規劃、原生圖表與資訊圖，以及包含圖片、PDF 和音訊的多模態 Grounding。
• 媒體生成：使用 Nano Banana 2 和 Google Image Search Grounding 進行圖片生成、使用 Lyria 3 進行音樂生成，以及使用多說話者 TTS 進行有感情的語音生成。
• 從角色到步驟：簡化的架構，每個動作（user_input、thought、function_call、model_output 等）都是一個獨立的類型化步驟，取代舊的角色結構。
• 成本與開發者優化：Flex 和 Priority 層級讓你可以針對成本或延遲進行優化（Flex 提供 50% 的成本降低）。錯誤現在會精確指出具體欄位。過去的互動可以擷取，付費層級保留 55 天。

開發的新標準

Interactions API 現在是 Google AI Studio、Gemini API 以及我們所有文件的預設選項，文件中包含一個切換開關，可將程式碼片段切換回舊版格式。我們建議所有新專案和應用程式使用 Interactions API。

雖然舊版的 generateContent API 仍受完全支援，並會在可預見的未來繼續接收新的 Gemini 主線模型，但我們預期適用於長時間運行模型和 Agent 的前沿能力將越來越多地專屬於 Interactions API。這是因為它從基礎就是為有狀態的、Agentic 的工作流程而設計。我們已發布遷移指南幫助你按照自己的步調進行轉換。

以 Agent 為優先的生態系統

大多數開發者現在使用編碼 Agent（例如 Antigravity）來建構應用程式。為了讓 Agent 更容易跟上最新的 API 模式，我們建立了 gemini-interactions-api 技能。它會將 Interactions API 開發的最佳實踐模式注入你的 Agent 的上下文（串流、函式呼叫、結構化輸出、Deep Research 等）。

1npx skills add google-gemini/gemini-skills --skill gemini-interactions-api

開始使用

Interactions API 可透過 Python 和 JavaScript SDK 使用。如果你已經在使用我們支援的合作夥伴之一（LiteLLM、Eigent 或 Agno），你現在就可以開始使用他們的 Interactions API 整合。

從 Google AI Studio 取得你的 API 金鑰，然後依照 Interactions API 文件開始使用。如果你從 generateContent 遷移，我們的遷移指南會將每個欄位對應到新的架構。你也可以查看完整的 OpenAPI 規格。

Interactions API 是根據開發者回饋建構的，這項重點不會因正式發佈而改變。請在開發者論壇上告訴我們你的需求。