Gemini API CLI 實驗預覽：給編程 agent 的 API 金鑰 CLI，不是 Gemini CLI

Google AI Studio 的介紹頁標註發布日期為 2026 年 10 月 19 日（約合北京時間 10 月 19–20 日，視美西發文時刻而定）。頁面介紹 Gemini API CLI 的實驗預覽——命令二進位名為 gemini-api——面向終端與已有 shell 權限的編程 agent，強調無依賴、無狀態。Google AI Studio / DeepMind 員工帳號也在 X 於 2026 年 10 月 22 日轉發同一預覽（約合北京時間 10 月 22 日 23:12）。按預覽工具理解即可，不要當成穩定 GA。

官方頁與 GitHub README 寫明的用途：把 gemini-api 放進 PATH，設定 Gemini API 金鑰，讓宿主 agent（Codex、Claude Code、Cursor、Antigravity 或其他可執行 shell 的 agent）用常規命令呼叫 Gemini——文字生成、影像 / TTS / 音樂 / 影片、多模態分析與轉寫，以及回傳 interaction id、可輪詢的託管 agent 執行。媒體類命令被描述為把檔案寫到磁碟並只列印路徑，減輕 agent 上下文被二進位撐爆。鑑權走 API 金鑰：匯出 GEMINI_API_KEY，或用 gemini-api configure 寫入系統鑰匙圈 / 本機設定。倉庫授權為 Apache 2.0。

這是 experimental / 實驗預覽（介紹頁還寫 v0.4.x 隨 Gemini Interactions API 演進）——不是命令面已凍結的正式版。我們未安裝、也未實測 gemini-api。它與 Gemini CLI 不是同一條產品線：後者的方案用量上限，站內已有專文 Gemini CLI 各方案的用量上限怎麼算。本文寫的是 Gemini API CLI（API 金鑰）；那篇寫的是 Gemini CLI 限額。兩名混用會走到錯誤安裝與鑑權路徑。

站內相鄰的 Google agent 語境可參見 Google Gemini agent：同時調用 Gemini 和 Claude 與 面向 agent 的隔離執行環境 Agent Compute Engine。官方未給出 gemini-cli 與 gemini-api 的完整旗標對照表；我們不編造對照。