GEMINI 4 ARGON ERA 共 14 章 9,312 字 約 27 分鐘

Gemini 完整指南:方案、模型、Skills、AI Studio 與 Antigravity

持續更新的 Gemini 繁體中文參考:產品地圖、方案與價格、Gemini 4 世代模型、Canvas 與 Deep Research、Skills、個人化與記憶、Tasks 與 Chrome、AI Studio 與 Gemini API、Antigravity CLI、隱私與資料控制,事實皆依 Google 官方頁面查證。

作者:
Steven Chang
類型:
AI 開發工具
標籤:
Gemini、Antigravity、AI Studio、Gemini API、Skills
最後更新:
2026-11-06

關於這份指南

這份指南是 Gemini 的繁體中文參考文件,把 Google 官方頁面上分散的資訊整理成一份:有哪些產品、方案怎麼分、模型怎麼選、怎麼接 API、怎麼用命令列開發工具,以及資料會被怎麼處理。

查詢日期與使用方式

所有事實的查詢日期是 2026-11-06。 每章結尾會標出來源與查詢日期,指南內沒有標註的內容一律以這一天的官方頁面為準。

Gemini 這一年的變動非常大,名稱、方案、模型和價格幾乎都換過一輪。文中的價格、日期、功能範圍都可能再變,下決定之前請回到官方頁面再確認一次。

這一年變了什麼

如果你的認知還停在 2025 年,下面這幾件事需要先更新:

項目2026-11-06 的現況
旗艦模型Gemini 4 世代,旗艦是 Gemini 4 Argon,不是 Gemini 2.5 Pro
個人方案Google AI Plus、Pro、Ultra,不再是 Gemini Advanced
自訂指令Skills 正在取代 Gems,Gems 預計 2026 年 11 月起陸續停用
命令列開發工具Antigravity CLI(agy)取代 Gemini CLI
Jules官方公告 2026-12-31 終止服務
官方 API 文件網域ai.google.dev/gemini-api/docs/... 轉到 aistudio.google.com/docs/...

寫作原則

  • 只寫官方頁面上查得到的事實。查不到、各頁說法互相矛盾的地方,會直接寫「官方未公布」或「各頁說法不一致」,不用第三方數字補。
  • 台幣價格標「參考價」,以 Google 官方頁面當下顯示的為準。
  • 不排模型品質高低。各家發表的 benchmark 都是自己公布的,不能直接互比,請用自己的任務測試。
  • 文中有些功能有年齡、地區、帳號類型的限制,各章會分別標出。

怎麼讀

想知道該用哪個入口,看第 2 章。想知道要不要付費,看第 3 章。要寫程式或接 API,看第 10、11 章。擔心資料去哪,直接看第 12 章。

資料來源:Gemini release notes、Gemini API 模型頁、Gemini 訂閱方案(2026-11-06 查詢)

Gemini 是什麼:產品地圖

「Gemini」在 Google 內同時指模型家族和一整排產品。先分清楚入口,再決定要用哪一個。

一般使用者的入口

Google 的消費者方案頁把 Gemini 相關產品列成同一條產品線:

  • Gemini app:對話、檔案分析、Canvas、Deep Research、Gemini Live、圖片與影片生成。
  • Google Flow:影像與影片創作。
  • Gemini Notebook:和 NotebookLM 連動的筆記本(第 5 章)。
  • Gmail、Docs、Vids 裡的 Gemini:直接在 Google 的應用程式內使用。
  • Search 的 AI Mode 與代理功能。
  • Google Antigravity:開發用。
  • Project Genie:Ultra 方案。
  • YouTube Premium Lite、Premium:綁在 Pro、Ultra 方案。

桌面端:Gemini 的 Windows App 在 2026-09-10 上線;macOS 版在 2026-10-13 加入 Antigravity 程式碼介面。

開發者的三個入口

入口用途
Google AI Studio瀏覽器內試模型、拿 API key、Build mode
Gemini API把模型接進自己的程式
Google Antigravity讓 agent 寫程式的開發環境

Antigravity 官方文件列出四個 surface:

  • 桌面 App(v2.5 以上)
  • CLI agy(v1.2 以上)
  • IDE 擴充套件(VS Code、JetBrains、Visual Studio、Zed、Xcode、Eclipse)
  • Antigravity SDK(Python)

怎麼挑入口

你要做的事從這裡開始
日常問答、整理文件、做簡報素材Gemini app
讀 Gmail、Drive、行事曆並整理Gemini app 連結 Workspace(第 5 章)
試不同模型、寫提示詞、取得 API keyGoogle AI Studio
把 Gemini 接進自己的服務Gemini API
讓 agent 在專案裡改程式Antigravity(第 11 章)
公司統一管理、資料不外流Gemini Enterprise 或 Workspace(第 3、12 章)

近期官方更新時間軸

官方 release notes 近三個月的重點日期:

日期內容
2026-08-19學生中樞
2026-09-10Windows App 上線
2026-09-30Skills
2026-10-13Gemini 4 Argon、macOS 版 Antigravity、連結更多應用程式

查詢當天(2026-11-06),release notes 尚無 11 月條目。

資料來源:Gemini 訂閱方案(台灣)、Google Antigravity 入門、Gemini release notes(2026-11-06 查詢)

方案與價格

Gemini 的個人方案現在是 Google AI Plus、Pro、Ultra 三級,加上免費版。方案不只決定模型,還綁了儲存空間、Flow credits 和其他 Google 服務。

個人方案(台灣)

下表是台灣版官方頁的標價,NT$ 為參考價,實際請以結帳頁為準:

方案月費(參考價)用量模型(官方頁寫法)儲存空間Flow credits
免費NT$0基準Flash-Lite15 GB限量 Nano Banana Pro
Google AI PlusNT$165免費版的 2 倍Flash,含影片生成400 GB200
Google AI ProNT$650免費版的 4 倍Gemini 4 Argon、Pro、Flash5 TB1,000
Google AI UltraNT$3,300 起(Pro 的 5 倍用量);NT$6,500(Pro 的 20 倍用量)Pro 的 5 倍或 20 倍Argon、Pro、Flash,最高存取等級至少 20 TB10,000 或 25,000

Ultra 兩檔各自對應哪個 Flow credits 數字,官方頁沒有寫清楚。

Pro 另外包含:1M token 視窗、Deep Research、Veo 3.1 Lite 限量試用、YouTube Premium Lite、Antigravity 的基本 agent 模型存取,以及 Notebook 音訊摘要等額度 5 倍。Ultra 另外包含:YouTube Premium 個人版、Project Genie、Antigravity 的 5 倍或 20 倍額度,以及 Tasks in Gemini 的早期存取(限特定國家)。

美國官方價

方案月費
FreeUS$0
PlusUS$4.99
ProUS$19.99
UltraUS$99.99(Pro 的 5 倍用量)/US$199.99(Pro 的 20 倍用量)

方案可隨時取消,部分計費週期不退款(法規要求者除外)。學生方案的條件請看 2026-08-19 的 release note。

台灣能不能買

官方「Gemini Apps limits & feature availability」的國家清單中,Taiwan 同時在 AI Plus 與 AI Pro、Ultra 的可用名單。

用量怎麼算

  • 用量是運算量,不是固定則數。
  • 每 5 小時重置,直到達到每週上限。
  • 影片生成最耗用量,其次是 Deep Research,一般聊天最省。
  • 可以購買 AI credits 加量;到 Settings 的 Usage Limits 查看目前用量。
  • 用量用完後,仍可繼續使用 Flash-Lite。
  • 官方說明限額可能隨容量調整,不另行通知。

Context 視窗(Gemini app)

方案視窗
未訂閱32k
AI Plus128k
AI Pro、Ultra1M

企業與團隊方案

方案價格(美元,每 seat 每月)
Gemini Enterprise BusinessUS$21(最多 300 seats)
Gemini Enterprise Standard、PlusUS$30(seats 不限,洽 sales)

Google Workspace 的方案頁也列有含 Gemini 的方案(AI 聊天、Notebook、Gmail、Drive、Sheets、Meet 的 AI 功能),Enterprise 為洽詢。台幣價格官方未公布。

Antigravity 的方案

所有方案都有 Gemini 3.8 Flash 和無限 Tab completion。Pro 有每 5 小時重置的額度加每週上限,Ultra 最高。Pro、Ultra 可購買 AI credits 超額使用(可設定 Never 或 Always)。不支援自帶 API key(BYOK)。 具體額度數字官方沒有公開,只寫「更高」。

資料來源:Gemini 訂閱方案(台灣)、Gemini 訂閱方案(美國)、Gemini Apps limits & feature availability、Antigravity Plans、Google Workspace AI(2026-11-06 查詢)

模型家族

Gemini 2026 年進入 4 世代。API 上的可用型號和狀態如下,下表來自官方 models 頁(2026-11-06)。

Gemini API 的可用模型

型號model ID狀態備註
Gemini 4 Argongemini-4-argon穩定旗艦推理模型
Gemini 3.8 Flashgemini-3.8-flash穩定2026-09
Gemini 3.7 Flash官方 models 頁未列DeepMind 頁標示 2026-08Antigravity 中僅 Enterprise
Gemini 3.6 Flashgemini-3.6-flash穩定2026-07
Gemini 3.5 Flash-Litegemini-3.5-flash-lite穩定2026-07
Gemini 3.1 Flash-Litegemini-3.1-flash-lite穩定
Gemini 3.1 Progemini-3.1-pro-previewPreview另有 -customtools 變體
Gemini 3 Flashgemini-3-flash-previewPreview
Gemini 2.5 Pro、Flashgemini-2.5-pro、gemini-2.5-flash已棄用2026-12-01 起請求轉到 3.8 Flash、3.5 Flash-Lite
Gemini 2.5 Flash-Litegemini-2.5-flash-lite未棄用

專門用途的模型:Nano Banana 2.1(gemini-nano-banana-2.1)、Nano Banana 2(gemini-3.1-flash-image)、Nano Banana 2 Lite、Nano Banana Pro(gemini-3-pro-image)、Gemini Omni Flash、Gemini 3.8 Live、3.5 Transcribe、各種 TTS,以及 Gemini Embedding 2(gemini-embedding-2)。

Gemini 4 Argon

官方定位是旗艦推理模型,適合複雜軟體工程、數學科學、自主多步 agent 和長 decode。

項目規格
Context1,048,576 tokens(輸入、思考、輸出共用)
預設 max output65,536;long decode 最高 1,048,576(需 background: true 並把 max_output_tokens 設在 65,536 以上)
輸入文字、圖片、影片、音訊、PDF
輸出文字
Thinkinglow、medium、high,預設 medium
不支援Live API、圖像與音訊生成、顯式 cache
Cache隱式 cache 預設開啟,輸入達 4,096 tokens 以上才會生效

發佈時程:

  • 2026-09-30:先行提供給網路安全防禦者等 Fairwind Program。
  • 2026-10-13:在 Gemini app 對 AI Pro、Ultra 開放(Google 官方部落格)。
  • API:付費層可用,免費層不可用。

價格(美元,每百萬 token):

項目現價(至 2026-11-30)2026-12-01 起
輸入$2.00$4.00
輸出(含思考)$10.00$20.00
Cache$0.10$0.20
Batch 輸入$1.00$2.00
Batch 輸出$5.00$10.00

也就是說現行價是階段性價格,12 月起調整。

其他主力型號

Gemini 3.8 Flash:官方定位為最強的 Flash,用於長時間軟體工程、agent、企業工作流。輸入 1,048,576、輸出 65,536;thinking 為 low、medium、high,不支援 minimal,設了會報錯。價格 $0.75/$3.75,2027-01-01 起 $1.50/$7.50。免費層可用。

Gemini 3.5 Flash-Lite:低延遲、低成本,用於子 agent 和文件解析。價格 $0.30/$2.50,免費層可用(無 cache)。

Gemini 3.1 Pro Preview:輸入 200k 以內 $2、超過 $4;輸出 200k 以內 $12、超過 $18。免費層不可用。

Gemini 4 Carbon

DeepMind 頁把 Gemini 4 Carbon 列為 next frontier model。寫稿當下未對一般使用者公開,API 價格頁也沒有它,細節官方未公布。

Thinking 設定

模型可用等級與預設
Argon、3.8 Flashlow、medium(預設)、high
3.6 Flashminimal 到 high
3.5 Flash-Lite預設 minimal
3.1 Pro預設 high

思考 token 和輸出 token 一起計費。API 只回傳思考摘要(thinking_summaries: "auto"),但按完整思考計費。官方建議各個等級都跑一次自己的評估,選能達標的最低一級。

參數變動

Gemini 3.6 以後與 Gemini 4:請從請求移除 temperature、top_p、top_k。這些參數目前被忽略,之後會改成報錯。

Antigravity 內可選的模型

模型可用方案
Gemini 4 ArgonPro(付費或試用)、Ultra、Enterprise
Gemini 3.8 Flash全方案
Claude Sonnet 5.5、Opus 5.5(thinking)Pro 付費、Ultra、Enterprise
GPT-OSS-120b官方未標明方案

Claude Sonnet 4.6、Opus 4.6 與 GPT-OSS-120b 預定 2026-11-18 移除。推理強度有 Low、Medium、High 三級。

Gemini app 內能選什麼

官方 support 頁明說不逐方案列出模型。訂閱頁的寫法是:免費版 Flash-Lite、Plus 為 Flash、Pro 含 Argon、Pro、Flash。各頁說法略有出入,實際以你帳號模型選單為準。

資料來源:Gemini API Models、Gemini 4 Argon、Gemini 3.8 Flash、Gemini 3.5 Flash-Lite、Pricing、Thinking、Gemini 3 開發指南、DeepMind Gemini 模型頁、Gemini 4 availability、Antigravity Models(2026-11-06 查詢)

日常對話與檔案:Canvas、Notebook、Deep Research

這章是 Gemini app 裡最常用的幾個工作流,以及各自的限制。

Canvas

Canvas 是和 Gemini 一起編輯成品的工作區,可以做:

  • 寫作與文件
  • 程式
  • app 與遊戲
  • 網頁
  • 資訊圖表
  • 測驗
  • 語音摘要

所有 Gemini 使用者都能用;Pro、Ultra 有 1M 視窗。專案可以用連結分享。行動版看得到專案,但編輯文字格式只能在桌機網頁版。

Deep Research

Deep Research 會先產生一份可編輯的研究計畫,確認後才開始查。

項目說明
預設來源Google 搜尋
可加來源Gmail、Drive(需連結 Workspace)、上傳檔案、NotebookLM 筆記本
耗時一份報告通常約 5 到 10 分鐘,可背景執行
模型所有使用者可用 Thinking;Pro、Ultra 可用 Pro 模型,報告品質更高
上限有「每日請求數」與「同時請求數」上限,Pro、Ultra 較高;官方沒有公布具體數字
Ultra報告可出現圖表、示意圖與互動模擬(使用 Workspace 來源時不可)
後續可轉成音訊摘要、Canvas 視覺化、匯出到 Docs
條件需年滿 18 歲;要看歷史報告需開啟 Keep Activity

Gemini Notebook

2026-04-08 起,Gemini 內有「Notebooks」,和 NotebookLM 雙向同步:在任一邊加入來源,另一邊也看得到。可以加入自訂指令與檔案。公告當時不支援未滿 18 歲,以及 Workspace、Education 帳號。Pro 方案的 Notebook 音訊摘要等額度為 5 倍。

官方對 Notebook 的來源數量、免費額度沒有公開數字。

連結 Google Workspace

在 Gemini 中連接 Google Workspace app 後,可以:

  • 搜尋、摘要 Gmail、Docs、Drive
  • 管理 Tasks、Keep、Calendar

使用方式是輸入 @ 選擇服務。前提條件:

  • 必須開啟 Keep Activity(見第 12 章)。
  • 工作或學校帳號需要管理員允許。
  • Gmail 的智慧功能要開啟。

目前做不到的事: 讀取 Docs、Gmail 內的留言與圖片;管理 Drive(建立資料夾、搬移檔案);計算或回報儲存空間。

小提醒

  • 模型選擇、用量上限見第 3、4 章。
  • Guided Learning(逐步引導學習)曾在 2025-08 推出,2026 年官方概覽頁已經查不到,本指南不列為核心功能。

資料來源:Canvas、Deep Research 說明、Deep Research 概覽、連結 Google Workspace app、Notebooks 公告(2026-11-06 查詢)

Skills 與 Gems

Gemini 把「儲存一次、重複使用的指令」從 Gems 換成 Skills。現在正是過渡期,兩者並存,所以這章以 Skills 為主,Gems 只說明終止時程與遷移。

Skills 是什麼

2026-09-30 官方部落格公布 Skills:

  • 把常用的指令儲存一次,之後輸入 / 加名稱就能執行。
  • 可以從現有對話直接建立。
  • 可以多個 skill 疊用。
  • 支援參考檔案:文字、PDF、圖片。
  • 所有 Google AI 訂閱層都可用。
  • 目前限 18 歲以上。
  • Gemini Spark 已支援 Skills。

Skills 即將取代 Gems。官方說之後會補上 Gems 原有的分享,以及 Drive、Notebook 檔案的支援。

Gems 終止時程

帳號類型停用時間
個人帳號2026 年 11 月(官方未寫確切日期)
Workspace 商務、企業、非營利2027 年 3 月
教育2027 年 6 月
  • 停用時,Gems 會自動轉成 skills。
  • Opal 同樣在 11 月關閉。
  • Google Labs 的 Gems 會關閉,且不會遷移。
  • 查詢當天官方頁面仍把 Gems 列在免費方案功能中,也就是說過渡期內兩者並存。

怎麼做

  1. 把現有的 Gems 內容(指令與參考檔案)自己留一份備份。
  2. 在對話中試用 /,確認 skill 的名稱和內容符合預期。
  3. 需要分享給別人的 Gem,先確認新的 Skills 是否已補上分享功能,再決定要不要重建。

命令列開發工具的 skills

Antigravity 也有自己的 skills 機制,遵循 agentskills.io 開放標準,格式和上面的 app 版 Skills 不同。這部分見第 11 章。

資料來源:Skills 官方部落格、Gems 概覽(2026-11-06 查詢)

個人化與記憶

Gemini 有三種讓它「更認識你」的機制:連結你的 Google 資料(Personal Intelligence)、跨對話記憶,以及從其他 AI 匯入。

Personal Intelligence

2026-01-14 以 beta 推出。

項目說明
可連結Gmail、相簿、YouTube、搜尋
預設關閉,可逐一選擇要連結哪些 app
來源可以要求 Gemini 顯示引用了哪些來源
訓練官方說明不直接用 Gmail 收件匣與相簿資料訓練,只在過濾或去識別後使用有限資訊(提示詞與回應)
帳號僅限個人 Google 帳號,不含 Workspace Business、Enterprise、Education
年齡需年滿 18 歲

現行官方概覽頁寫的是全球 beta,排除歐洲經濟區、瑞士、英國、奈及利亞。頁面沒有逐一列出台灣,台灣不在排除名單內,但頁面要求「須符合資格」,實際能不能開以你的帳號設定為準。

記憶與匯入

2026-03-26 推出匯入功能:

  1. 到 Settings 選匯入。
  2. 複製 Gemini 提供的提示詞,貼到舊的 AI app。
  3. 把舊 AI 回傳的摘要貼回 Gemini。
  4. 也可以直接上傳 ZIP 匯入聊天紀錄。

限制:所有消費者帳號可用;不支援 Business、Enterprise、未滿 18 歲;歐洲經濟區、英國、瑞士尚未開放。原本的「past chats」改名為「memory」。

Gemini Live 也能記住跨對話的細節,例如飲食偏好、重要日期。

隱私上的關聯

記憶、Workspace 連結與 Keep Activity 的設定有關,細節見第 12 章。如果打算關閉 Keep Activity,要先知道關閉後 Gemini 就無法連接 Google Workspace。

資料來源:Personal Intelligence 公告、Personal Intelligence 概覽、匯入記憶公告、Gemini Live(2026-11-06 查詢)

Tasks 與 Chrome 裡的 Gemini

這章是 Gemini 的代理類功能:讓它在你不操作的時候替你完成事情。這是目前變動最大、各官方頁說法最不一致的一塊,使用前請以自己帳號畫面為準。

Tasks mode

官方 2026-10-13 的公告:

  • 主聊天視窗有切換鈕,可以從聊天切到 Tasks。
  • Gemini 能在你不在電腦前時,跨 Google 應用程式完成任務。
  • Gemini 連結「40 多個 app」,例如 Instacart、OpenTable、Adobe、Shopify。
  • Pro、Ultra 訂閱者可以「指派任務」。

方案與地區:各頁說法不同

官方頁面說法
消費者方案頁「Tasks in Gemini」只列在 Ultra,標示早期存取、限特定國家
Gemini 部落格(2026-10-13)Pro、Ultra 訂閱者可指派任務
Support 功能表未清楚標示 Pro 是否包含

台灣是否已可用、Pro 是否包含,官方沒有一致說明。

Spark

Spark 是 Google I/O 2026(2026-05-19)發表的背景 agent,5 月底起對美國 Ultra、18 歲以上開放。2026-09-30 的 Skills 公告仍寫「Gemini Spark 已支援 Skills」,但現在官方頁面多半只提 Tasks。Spark 與 Tasks 的命名關係,官方沒有明講。

Gemini in Chrome

  • 摘要分頁、比較多個分頁、使用 Gemini Live。
  • 自動瀏覽(auto browse):目前僅美國預先發布版,限 Pro、Ultra。
  • Android 可處理螢幕內容;iOS 的 Chrome 內建。
  • 台灣:官方地區選單有台灣,但頁面沒有明確說明台灣已可用;台灣媒體報導 2026-04-21 起台灣可用。

連結的 app

2026-08-12 的 Made by Google 活動新增的連結 app(逐步推出):Granola、Otter.ai、Wix、Fever、GetYourGuide、Localiza、OpenTable(英國)、Ticketmaster、iHeartRadio、Pandora、Angi、Thumbtack、Zocdoc。

使用建議

  • 代理類功能會替你操作帳號或下單,第一次使用先從低風險的任務(查資料、整理行程)開始。
  • 連結新 app 前,先看清楚它能存取哪些資料。

資料來源:Gemini 4 availability(含 Tasks mode)、Gemini 訂閱方案、Gemini Apps limits & feature availability、Gemini in Chrome、新增連結 app、Skills 公告、台灣媒體報導(technews)(2026-11-06 查詢)

語音、圖片、影片

Gemini Live

點 Live 圖示就能用語音和 Gemini 對話:

  • 可以隨時打斷、換話題。
  • 語音與文字在同一串對話。
  • 可以顯示地圖、天氣卡、照片。
  • 可連結 Gmail、Drive、Calendar、Tasks、Keep、Maps、YouTube、智慧家庭。
  • 可以用相機拍給它看。
  • 可以記住跨對話的細節。

限制:Live 不能使用 Gems、Notebook,也不支援 Omni、Lyria。 官方頁面沒有列出支援的語言與螢幕分享,繁體中文是否支援,官方頁沒寫。

圖片生成

模型說明
Nano Banana 2免費版可用:角色一致性、文字渲染、合併照片、2K
Nano Banana 2.1目前最強,需 Google AI 訂閱
Nano Banana ProPro、Plus、Ultra 可從「…」選單重新生成

所有生成的圖片都含不可見的 SynthID 與可見浮水印。你可以上傳檔案,請 Gemini 驗證是否為 Google AI 生成。使用需年滿 18 歲。

影片生成

  • app 內影片生成改用 Gemini Omni 1.1 Flash,取代 Veo 3.1。
  • 10 秒影片、內建語音。
  • 支援圖生影片(最多 5 張參考圖)、影片編輯、延長場景、AI avatar。
  • 需要訂閱。
  • 解析度與每日上限官方沒有寫。
  • 影片同樣含 SynthID。

影片是用量消耗最大的功能(第 3 章),訂閱前先估算自己的使用頻率。

API 端

圖片與影片模型的 model ID 見第 4 章。這些模型的 API 價格不在本指南範圍,請見官方 pricing 頁。

資料來源:Gemini Live(台灣)、圖片生成、影片生成(2026-11-06 查詢)

Google AI Studio 與 Gemini API

取得 API key

到 aistudio.google.com/apikey 建立。SDK 讀的環境變數是 GEMINI_API_KEY 或 GOOGLE_API_KEY,兩者同時存在時 GOOGLE_API_KEY 優先。

2026-05-28 起,新建立的 key 都是 auth key(綁定 service account)。無限制的 standard key 會被拒絕,有明確限制的 standard key 仍可使用。

SDK 與第一個請求

pip install -U google-genai
npm install @google/genai

主要介面已改為 Interactions API:

from google import genai

client = genai.Client()
interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Explain how AI works in a few words",
)
print(interaction.output_text)
  • 伺服器端狀態用 previous_interaction_id 串接。
  • REST 要帶 Api-Revision: 2026-05-20 header。
  • 官方另提供 gemini-api CLI。
  • 官方 quickstart 說 Interactions API 取代舊的 generate-content 模式;舊介面何時淘汰,官方頁沒有寫清楚,既有程式請先在官方文件確認。

免費層與付費層

官方 pricing 頁標示可免費使用的文字模型:3.8 Flash、3.6 Flash、3.5 Flash-Lite、3.1 Flash-Lite、3 Flash Preview、2.5 系列。Gemini 4 Argon 與 3.1 Pro Preview 不可用。

免費層的具體 RPM、RPD,官方公開頁沒有直接給數字,需要登入 AI Studio 的 rate-limit 頁面查看。

層級條件月上限
Free有效專案不適用
Tier 1綁定計費帳戶並預付US$250
Tier 2累積付款 US$100 且滿 3 天US$2,000
Tier 3累積 US$1,000 且滿 30 天US$20,000 至 US$100,000 以上
  • 限額按專案計算,不是按 key。
  • RPD 在太平洋時間午夜重置。
  • Search grounding 預設每個專案 1,500 RPD。

預付與計費

項目說明
預付金額最少 US$5、最多 US$5,000
點數期限12 個月到期
餘額歸零同一計費帳戶下所有專案的 key 一起失效(HTTP 402)
帳務延遲約 10 分鐘
專案月上限可設定(實驗中)

價格(標準層,美元/每百萬 token,輸入/輸出)

模型價格
Gemini 4 Argon$2.00/$10.00(至 2026-11-30),2026-12-01 起 $4.00/$20.00
Gemini 3.8 Flash$0.75/$3.75(至 2026-12-31),2027-01-01 起 $1.50/$7.50
Gemini 3.5 Flash-Lite$0.30/$2.50
Gemini 3.1 Flash-Lite$0.25/$1.50
Gemini 3.1 Pro Preview$2/$12(200k 以內)、$4/$18(超過 200k)
Gemini 2.5 Flash-Lite$0.10/$0.40

Batch 的價格約為標準價的一半(以 Argon 為例,現價 Batch 為 $1/$5)。音訊、圖片、TTS、embedding 等其他模型的價格本指南未收錄,請見官方 pricing 頁。

Argon 的 API 實務

  • 移除 temperature、top_p、top_k。
  • max_output_tokens 含思考。舊 app 若設在 32K 以下,請提高到至少 32,768。
  • 難題的 HTTP timeout 至少設 15 分鐘。
  • 長輸出需使用 background: true,且不支援顯式 cache。

其他 API 工具

Search grounding、Google Maps grounding、code execution、computer use、file search、URL context、function calling、structured outputs、Batch、Flex 與 Priority inference。

長 context 的用法

  • 問題放在 context 之後。
  • 重複使用的內容用 cache。
  • 同時檢索多個目標時準確度會下降。
  • 1M token 大約是 5 萬行程式碼,或 8 本小說。

AI Studio 的 Build mode

官方文件頁沒有說明 Build mode 的細節,本指南不收錄。

資料來源:API key、Quickstart、Pricing、Rate limits、Billing、Gemini 3 開發指南、Long context(2026-11-06 查詢)

Antigravity 與 Antigravity CLI

Google 的 agent 開發工具在 2026 年整合成 Google Antigravity。Gemini CLI 已轉進 Antigravity CLI(命令 agy),Jules 則宣布終止。這章以 agy 為主,Gemini CLI 與 Jules 放在後面說明。

Antigravity 的四個 surface

桌面 App(v2.5 以上)、CLI agy(v1.2 以上)、IDE 擴充套件(VS Code、JetBrains、Visual Studio、Zed、Xcode、Eclipse)、Antigravity SDK(Python)。方案與額度見第 3 章,可選模型見第 4 章。

安裝 agy

# macOS / Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Windows PowerShell
irm https://antigravity.google/cli/install.ps1 | iex

# Verify
agy --version

預設安裝在 ~/.local/bin/agy。

認證方式有三種:

方式設定值適用
Google 帳號 OAuthoauth-personalFree、Pro、Ultra
Gemini API keygemini-api-key自帶 key
Enterprise/Agent PlatformPreview企業

SSH 等無頭環境會印出授權網址與 6 位數 OTP。用 API key 時,官方設定頁的寫法是 modelProvider: "gemini" 搭配 GEMINI_API_KEY。

常用指令

指令用途
agy開啟互動式 TUI
agy -i "prompt"以初始提示開啟互動工作階段並繼續對話
agy -p "prompt"單次非互動(headless)執行並印出回應
agy plugin import gemini掃描舊版 Gemini CLI 的本機目錄與 extension manifest,轉成原生格式

對話中可用的斜線指令包含 /model、/usage、/fast、/resume、/permissions、/mcp、/skills、/agents、/statusline、/goal、/grill-me、/schedule、/browser、/plugin。實際清單隨版本變動,以輸入 / 後看到的為準。

Shift+Tab 切換 auto、plan、default、accept-edits 模式;Ctrl+R 查看 artifact。

設定檔

位置是 ~/.gemini/antigravity-cli/settings.json(權限 0600)。

  • 權限規則分 allow、ask、deny,優先順序 deny > ask > allow,格式像 command(git status)。
  • 其他常見 key:model、modelProvider、agentMode、toolPermission、enableTerminalSandbox、allowNonWorkspaceAccess。
  • Hooks、MCP、plugins 放在 ~/.gemini/config/ 或 <workspace>/.agents/。
  • 遙測選項存在帳號而不是設定檔,商務帳號永遠關閉。

規則檔:GEMINI.md 與 AGENTS.md

Antigravity 會在每一層目錄找 AGENTS.md 或 GEMINI.md,也讀 .agents/AGENTS.md、.agents/GEMINI.md、.agents/rules/*.md。

範圍位置
全域~/.gemini/AGENTS.md、~/.gemini/GEMINI.md、~/.gemini/config/{AGENTS,GEMINI}.md、~/.gemini/config/rules/*.md

注意事項:

  • 規則是累加,不是覆蓋。
  • rules/ 內的每個 .md 需要 frontmatter 與 trigger,可用值為 always_on、model_decision、glob、manual。格式不對會被靜默丟棄。
  • 單一檔案超過 24,000 bytes 會被截斷。
  • 全域規則與 always_on 共用 20,000 token 的預算。

MCP

全域設定 ~/.gemini/config/mcp_config.json,工作區設定 <workspace>/.agents/mcp_config.json:

{
  "mcpServers": {
    "sqlite-explorer": {
      "command": "node",
      "args": ["/path/server.js"],
      "env": { "K": "V" }
    },
    "my-remote-server": {
      "serverUrl": "https://api.example.com/mcp/",
      "headers": { "Authorization": "Bearer TOKEN" },
      "timeoutSeconds": 600
    }
  }
}
  • 遠端必須是 Streamable HTTP,url 可代替 serverUrl。
  • 不支援舊的 HTTP+SSE 與 httpUrl。
  • 預設連線與列工具的逾時是 300 秒,工具呼叫是 180 秒。
  • /mcp 開啟管理面板。

Skills

Antigravity 的 Skills 遵循 agentskills.io 開放標準:

  • 一個資料夾放一份 SKILL.md,frontmatter 的 description 必填,name 選填。
  • 工作區放 .agents/skills/,全域放 ~/.gemini/config/skills/。
  • CLI 另外會讀 ~/.gemini/antigravity-cli/skills/ 與 ~/.gemini/skills/。
  • 每個 skill 在 CLI 裡變成一個斜線指令;改了檔案用 /skills reload 重新載入。

Gemini CLI 的結局

官方 developers blog(2026-05-19)宣布 Gemini CLI 轉進 Antigravity CLI:

  • 2026-06-18 起,Gemini CLI 與 Gemini Code Assist IDE 擴充不再服務 Google AI Pro、Ultra 與免費 Code Assist 個人用戶。
  • 持有 Gemini Code Assist Standard 或 Enterprise 授權的組織不受影響。
  • Gemini CLI 仍可使用付費 Gemini 或 Enterprise Agent Platform 的 API key。
  • 官方承認兩者並非 1:1 功能對等。
  • 保留下來的概念:Agent Skills、Hooks、Subagents、Extensions(改稱 Antigravity plugins)。

Gemini CLI 的 GitHub 頁面現在標示「僅限 Enterprise Code Assist」,並註明未針對 Gemini 4 優化,不要用來跑模型 benchmark。它仍可用 npm install -g @google/gemini-cli 或 brew install gemini-cli 安裝,支援 gemini -p 與 --output-format json,MCP 設在 ~/.gemini/settings.json。如果你是企業用戶或有舊專案,可以繼續用;新專案建議從 agy 開始。

從 Gemini CLI 遷移

首次執行 agy 會偵測舊設定,提供勾選清單;也可手動執行 agy plugin import gemini。

舊設定遷移後
GEMINI.md、AGENTS.md原樣可用
全域 ~/.gemini/skills/原樣可用
.gemini/skills/需搬到 .agents/skills/
settings.json 內聯的 MCP需搬到 mcp_config.json,url、httpUrl 改為 serverUrl
自訂 commands轉成 skills
佈景主題不一定支援
Hooks官方遷移頁沒有說明

Jules

官方 changelog 在 2026-10-29 公告:Jules 將於 2026-12-31 終止服務。 2026-11-11 前請完成進行中的 session,之後變成唯讀。

  • 可用 Jules Tools(CLI)匯出設定、環境變數(包含值)、排程任務、連結的 repo、memories、setup scripts 與全部 sessions。
  • 程式碼與 PR 本來就在 GitHub。
  • 公告說 Jules 的經驗會用在 Antigravity,但沒有說明遷移路徑。

所以本指南不把 Jules 當作可以開始使用的工具。

資料來源:Antigravity 入門、Settings、Rules、MCP、Skills、從 Gemini CLI 遷移、Gemini CLI 轉進 Antigravity CLI 公告、Gemini CLI GitHub、Jules changelog(2026-11-06 查詢)

隱私與資料控制

Gemini 的資料處理依「用哪個產品、付不付費、開不開某個設定」而不同。這章分成消費者 app、API、Workspace 和 Antigravity 四塊。

Gemini app(消費者)

核心設定叫 Keep Activity。

狀態結果
Keep Activity 開啟聊天與上傳存在 Gemini Apps Activity,且用於提供、開發與改進服務,包含訓練生成式 AI 模型
Keep Activity 關閉,或使用暫時聊天對話在帳號中保留 72 小時(最近 24 小時當作上下文);關閉後的新對話不用於訓練(除非你提交回饋)
暫時聊天不用於訓練,也不用於人工審閱改進
  • 預設自動刪除為 18 個月,可改成 3 個月、36 個月或不限期。
  • 人工審閱: 部分聊天會由人工審閱者(含受過訓練的服務供應商)審閱,審閱前會與帳號脫鉤。被審閱的聊天最多保留 3 年,即使你刪除活動也不會刪除。
  • Keep Activity 關閉時,Gemini 無法連接 Google Workspace,Deep Research 的歷史報告也看不到。
  • Personal Intelligence 預設關閉,可按 app 個別開關(第 7 章)。

Gemini API 與 AI Studio

類型資料處理
免費(Unpaid Services)Google 使用你送出的內容與回應來提供、改進、開發產品;人工審閱者可以讀取、註記與處理(先與帳號、API key、專案脫鉤)。官方明寫不要提交敏感、機密或個人資訊
付費(Paid Services,含已綁定計費帳戶的 AI Studio)不用你的 prompt 與回應改進產品;為偵測違反使用政策並符合法規要求,Google 會在有限期間記錄;資料可能暫存或快取於 Google 或其代理設施所在的任何國家;條款未提到人工審閱

另外:對歐洲經濟區、瑞士、英國的使用者提供 API client 時,只能使用付費服務。

所以處理客戶資料、內部文件時,免費層不適合;要綁定計費帳戶。

Google Workspace

官方頁寫:貴公司資料完全屬於貴公司,且不會用於訓練模型;Gemini 只擷取使用者有權限存取的內容。官方也列出 ISO 42001 與 SOC 1、2、3。

Antigravity

CLI 有 Enable Telemetry 選項,開啟時收集使用資料;商務帳號永遠關閉。

建議的設定

  1. 打開 Gemini 的 Activity 設定頁,確認 Keep Activity 的狀態與自動刪除期限。
  2. 涉及敏感內容時用暫時聊天。
  3. 需要連結 Workspace 或看 Deep Research 歷史時,要知道這兩者依賴 Keep Activity。
  4. 用 API 處理非公開資料時,用付費層。

資料來源:Gemini Apps 隱私與 Activity 說明、連結 Google Workspace app、Deep Research 說明、Gemini API 條款、Billing、Google Workspace AI、Antigravity Settings(2026-11-06 查詢)

常見問題、限制與提示詞技巧

限制與常見坑

項目說明
用量是運算量而不是則數;每 5 小時重置,並有每週上限;影片與 Deep Research 最耗
Argon 地區方案頁註腳寫 Gemini 4 Argon、Nano Banana Pro、Search 的 Deep Search 僅特定國家,但台灣版方案頁把 Argon 列在 Pro。官方沒有國家名單,以你帳號的模型選單為準
方案頁矛盾美國頁在 Plus 卡片下寫「Includes Gemini 4 Argon」,但 Plus 的模型列只有 Flash;Plus 的可用國家數也有不同寫法。本指南不放精確國家數
年齡AI 方案與許多功能要求 18 歲以上;Skills、Personal Intelligence、Notebook 對未成年與 Workspace 帳號有排除
Gemini Live不能使用 Gems、Notebook
Workspace 連結不能讀留言與圖片、不能管理 Drive(第 5 章)
Argon API長輸出要 background 與長 timeout;免費層沒有
2026-12-01gemini-2.5-pro、gemini-2.5-flash 的請求被轉向 3.8 Flash、3.5 Flash-Lite,舊程式的行為會改變
2026-11-18Antigravity 內的 Claude 4.6 系列與 GPT-OSS-120b 移除

官方提示詞建議

以下整理自 Gemini API 的 prompting strategies 與 Gemini 3 開發指南。

基本寫法

  • 直接說任務;指定長度、格式與要避免的項目。
  • 複雜的 JSON 輸出,用結構化輸出功能,不用文字描述。
  • Few-shot:給少數、多樣的範例,格式完全一致;範例太多會過擬合。
  • 給參考資料,並要求「只根據提供內容回答」。
  • 最新事實開 Search grounding,計算開 code execution。

結構

  • 用 XML 標籤或 Markdown 標題分隔角色、限制、脈絡與任務,擇一風格即可。
  • 長輸入把所有脈絡放前面,問題放最後,中間加轉折語,例如「根據以上資訊」。
  • 關鍵限制與人設放在 system instruction 或最前面。

風格與思考

  • Gemini 3 以後預設回答直接簡潔;要對話式或詳細,要明說。
  • 2.5、3 以後的模型會在內部推理,不用再要求「一步一步想」。很難的問題才加「仔細思考」,代價是更多思考 token。
  • Thinking 等級:三級都跑評估,選能達標的最低一級。

Agent

  • 寫明規劃方式、風險(讀取與寫入的差別)、何時要問使用者,以及重試規則。

範例:把官方建議套成一個提示

<role>你是技術文件編輯。</role>

<constraints>
- 只根據 <context> 的內容回答,找不到就說「資料中沒有」
- 輸出為 5 點以內的條列,每點不超過 40 字
</constraints>

<context>
(貼上文件內容)
</context>

根據以上資訊,整理出與退款流程有關的規則。

資料來源:Prompting strategies、Gemini 3 開發指南、Gemini 訂閱方案(美國)、Gemini 訂閱方案(台灣)、Antigravity Models(2026-11-06 查詢)

與 ChatGPT、Claude 的定位差異

這章只比較有官方頁面依據的項目。ChatGPT 與 Claude 的內容只查證到方案頁層級,沒有進入各自的說明中心,所以不放價格比較,也不判斷誰的模型比較強。

方案結構

面向Gemini(Google)ChatGPT(OpenAI)Claude(Anthropic)
個人方案階梯(美國)Free、Plus US$4.99、Pro US$19.99、Ultra US$99.99 與 US$199.99Free、Go、Plus、Pro;Pro 有三檔 usage tierFree、Pro(月付 US$20)、Max(US$100)
開發工具AI Studio、Gemini API、AntigravityCodexClaude Code
生態Gmail、Docs、Drive、Calendar、Photos、Maps、YouTube、Chrome、AndroidCodex、Projects、排程任務、Custom GPTsClaude Code、Projects、Claude in Chrome、Microsoft 365 整合
圖片與影片生成內建 Nano Banana 與 Omni 影片頁面提到圖片生成方案頁未列圖像生成

ChatGPT 方案頁在查詢時沒有顯示美元價格數字,所以上表不放。

Gemini 的三個差異點

1. 綁在 Google 帳號與儲存空間的整體包裹。 同一筆訂閱含 400 GB 到 20 TB 以上儲存空間、YouTube Premium Lite 或 Premium、Flow credits,以及 Gmail、Docs 內建的 Gemini。ChatGPT 與 Claude 的個人方案頁沒有這類綁定(以所查頁面為準)。

2. 開發工具集中在 Antigravity 一個入口,而且能選 Claude 模型。 Antigravity 內可選 Claude Opus 5.5、Sonnet 5.5(Pro 付費方案以上),不是只有 Gemini 模型(第 4 章)。

3. API 有免費層,但資料處理條款不同。 免費層限部分 Flash 系列,Argon 與 3.1 Pro 沒有免費層;免費層的資料會被用來改進產品且有人工審閱,付費層沒有(第 12 章)。

資料政策

項目GeminiClaude
消費者訓練資料Keep Activity 開啟時用於訓練;關閉或暫時聊天不用;被人工審閱的聊天最多保留 3 年官方頁寫消費者方案的模型訓練是 opt-out

ChatGPT 的資料政策本次沒有查證,不寫。

不比較的事

  • 模型品質: Google DeepMind 頁上的 benchmark 是 Google 自己發佈;其他家也是。各家自己發表的 benchmark 不能互比,請用自己的任務測試。
  • 誰比較便宜: 三家的用量機制不同。Google 是運算量加上 5 小時與每週重置;Claude 也有 5 小時與每週限制;ChatGPT 依模型有訊息上限。不能直接用月費比較。

怎麼選

挑你最常待的環境:每天都在 Gmail、Docs、Drive 裡工作,Gemini 的整合最順;開發時用什麼工具,看你的專案和團隊現在的習慣。各家方案和用量機制都在變,訂閱前先用免費版或短期方案試過自己的任務。

資料來源:Gemini 訂閱方案(美國)、ChatGPT Pricing、Claude Pricing、Antigravity Models、Gemini API 條款、DeepMind Gemini 模型頁(2026-11-06 查詢)

變更記錄

以下由本指南各章節檔案的 git 紀錄自動生成,共 1 筆。

  1. 2026-11-06

    feat: 作品頁加入 Gooliya LINE 官方帳號 bot,標示最新作品,手機版卡片改為精簡排版

    關於這份指南 · Gemini 是什麼:產品地圖 · 方案與價格 · 模型家族 · 日常對話與檔案:Canvas、Notebook、Deep Research · Skills 與 Gems · 個人化與記憶 · Tasks 與 Chrome 裡的 Gemini · 語音、圖片、影片 · Google AI Studio 與 Gemini API · Antigravity 與 Antigravity CLI · 隱私與資料控制 · 常見問題、限制與提示詞技巧 · 與 ChatGPT、Claude 的定位差異

    f358652

由 Steven Chang 維護

最後更新 2026-11-06 · 對應 Gemini app、Gemini API 與 Antigravity(2026-11-06 查詢)

看部落格文章 →

免費訂閱 Gooliya 鼓櫟數位電子報

雜談 AI、開發與自動化,新文章上線時寄給你。

訂閱服務由 Kit 提供,Email 只用來寄送新文章

分享

Gemini 完整指南:方案、模型、Skills、AI Studio 與 Antigravity
Gemini 完整指南:方案、模型、Skills、AI Studio 與 Antigravity

持續更新的 Gemini 繁體中文參考:產品地圖、方案與價格、Gemini 4 世代模型、Canvas 與 Deep Research、Skills、個人化與記憶、Tasks 與 Chrome、AI Studio 與 Gemini API、Antigravity CLI、隱私與資料控制,事實皆依 Google 官方頁面查證。

Gooliya 鼓櫟數位