關於這份指南
這份指南是 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 key | Google AI Studio |
| 把 Gemini 接進自己的服務 | Gemini API |
| 讓 agent 在專案裡改程式 | Antigravity(第 11 章) |
| 公司統一管理、資料不外流 | Gemini Enterprise 或 Workspace(第 3、12 章) |
近期官方更新時間軸
官方 release notes 近三個月的重點日期:
| 日期 | 內容 |
|---|---|
| 2026-08-19 | 學生中樞 |
| 2026-09-10 | Windows App 上線 |
| 2026-09-30 | Skills |
| 2026-10-13 | Gemini 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-Lite | 15 GB | 限量 Nano Banana Pro |
| Google AI Plus | NT$165 | 免費版的 2 倍 | Flash,含影片生成 | 400 GB | 200 |
| Google AI Pro | NT$650 | 免費版的 4 倍 | Gemini 4 Argon、Pro、Flash | 5 TB | 1,000 |
| Google AI Ultra | NT$3,300 起(Pro 的 5 倍用量);NT$6,500(Pro 的 20 倍用量) | Pro 的 5 倍或 20 倍 | Argon、Pro、Flash,最高存取等級 | 至少 20 TB | 10,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 的早期存取(限特定國家)。
美國官方價
| 方案 | 月費 |
|---|---|
| Free | US$0 |
| Plus | US$4.99 |
| Pro | US$19.99 |
| Ultra | US$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 Plus | 128k |
| AI Pro、Ultra | 1M |
企業與團隊方案
| 方案 | 價格(美元,每 seat 每月) |
|---|---|
| Gemini Enterprise Business | US$21(最多 300 seats) |
| Gemini Enterprise Standard、Plus | US$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 Argon | gemini-4-argon | 穩定 | 旗艦推理模型 |
| Gemini 3.8 Flash | gemini-3.8-flash | 穩定 | 2026-09 |
| Gemini 3.7 Flash | 官方 models 頁未列 | DeepMind 頁標示 2026-08 | Antigravity 中僅 Enterprise |
| Gemini 3.6 Flash | gemini-3.6-flash | 穩定 | 2026-07 |
| Gemini 3.5 Flash-Lite | gemini-3.5-flash-lite | 穩定 | 2026-07 |
| Gemini 3.1 Flash-Lite | gemini-3.1-flash-lite | 穩定 | |
| Gemini 3.1 Pro | gemini-3.1-pro-preview | Preview | 另有 -customtools 變體 |
| Gemini 3 Flash | gemini-3-flash-preview | Preview | |
| Gemini 2.5 Pro、Flash | gemini-2.5-pro、gemini-2.5-flash | 已棄用 | 2026-12-01 起請求轉到 3.8 Flash、3.5 Flash-Lite |
| Gemini 2.5 Flash-Lite | gemini-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。
| 項目 | 規格 |
|---|---|
| Context | 1,048,576 tokens(輸入、思考、輸出共用) |
| 預設 max output | 65,536;long decode 最高 1,048,576(需 background: true 並把 max_output_tokens 設在 65,536 以上) |
| 輸入 | 文字、圖片、影片、音訊、PDF |
| 輸出 | 文字 |
| Thinking | low、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 Flash | low、medium(預設)、high |
| 3.6 Flash | minimal 到 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 Argon | Pro(付費或試用)、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 列在免費方案功能中,也就是說過渡期內兩者並存。
怎麼做
- 把現有的 Gems 內容(指令與參考檔案)自己留一份備份。
- 在對話中試用
/,確認 skill 的名稱和內容符合預期。 - 需要分享給別人的 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 推出匯入功能:
- 到 Settings 選匯入。
- 複製 Gemini 提供的提示詞,貼到舊的 AI app。
- 把舊 AI 回傳的摘要貼回 Gemini。
- 也可以直接上傳 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 Pro | Pro、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-20header。 - 官方另提供
gemini-apiCLI。 - 官方 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 帳號 OAuth | oauth-personal | Free、Pro、Ultra |
| Gemini API key | gemini-api-key | 自帶 key |
| Enterprise/Agent Platform | Preview | 企業 |
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 選項,開啟時收集使用資料;商務帳號永遠關閉。
建議的設定
- 打開 Gemini 的 Activity 設定頁,確認 Keep Activity 的狀態與自動刪除期限。
- 涉及敏感內容時用暫時聊天。
- 需要連結 Workspace 或看 Deep Research 歷史時,要知道這兩者依賴 Keep Activity。
- 用 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-01 | gemini-2.5-pro、gemini-2.5-flash 的請求被轉向 3.8 Flash、3.5 Flash-Lite,舊程式的行為會改變 |
| 2026-11-18 | Antigravity 內的 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.99 | Free、Go、Plus、Pro;Pro 有三檔 usage tier | Free、Pro(月付 US$20)、Max(US$100) |
| 開發工具 | AI Studio、Gemini API、Antigravity | Codex | Claude Code |
| 生態 | Gmail、Docs、Drive、Calendar、Photos、Maps、YouTube、Chrome、Android | Codex、Projects、排程任務、Custom GPTs | Claude 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 章)。
資料政策
| 項目 | Gemini | Claude |
|---|---|---|
| 消費者訓練資料 | 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 查詢)