---
title: "Gemini 指令大全"
description: "收錄 140 個 Gemini 功能、快捷鍵、API 參數與隱藏技巧"
source: https://aiterms.tw/cheatsheet/gemini
version: "1.2.0"
lastUpdated: "2026-10-31"
---

# Gemini 指令大全

> 收錄 140 個功能、快捷鍵、API 參數與隱藏技巧。
> 版本：1.2.0 | 更新：2026-10-31

## ⌨️ 快捷鍵與操作（Shortcuts & Controls）

Gemini in Chrome、Gemini 桌面版、Gemini Code Assist 與 Gemini CLI 官方文件列出的鍵盤快捷鍵

### `Enter` : 送出訊息（基礎）

送出目前輸入框中的訊息給 Gemini

官方說明頁未列出，以實際介面為準

### `Shift+Enter` : 換行（基礎）

在輸入框中插入換行而不送出訊息

官方說明頁未列出，以實際介面為準

### `Alt+G / Ctrl+G (Mac)` : Chrome 開啟 Gemini（基礎）

開啟或關閉 Gemini in Chrome 側欄，ChromeOS 為 Search+G

需先啟用 Gemini in Chrome，可在 Chrome 設定中自訂快捷鍵

### `Alt+Shift+G / Ctrl+Cmd+G (Mac)` : 分頁與 Gemini 切換（進階）

在目前分頁與 Gemini in Chrome 之間切換焦點，ChromeOS 為 Search+Alt+G

### `Ctrl+Alt+G / Ctrl+Shift+G (Mac)` : 選取模式（進階）

啟動 Gemini in Chrome 的選取模式，選取頁面內容來提問，ChromeOS 為 Ctrl+Shift+G

### `@gemini + Tab` : 網址列直接問（基礎）

在 Chrome 網址列輸入 @gemini 再按 Tab 或空白鍵，輸入問題後按 Enter 跳到 Gemini 網頁版回答

### `Option+Space (Mac) / Alt+Space (Windows)` : 桌面版叫出 Gemini（基礎）

Gemini 桌面應用程式執行中時，從任何視窗叫出 Gemini 對話視窗

依官方說明，可在應用程式設定中自訂

### `Hey Google, let's talk Live` : 語音開啟 Live（基礎）

在 Android 手機或 Pixel Buds 說出喚醒語，直接開始 Gemini Live 語音對話

依官方說明，也可只說 Hey Google, let's talk

### `Tab` : 接受建議（基礎）

Code Assist 中按 Tab 接受程式碼自動完成建議，Next Edit 建議同樣按 Tab 接受

僅適用於 Gemini Code Assist IDE 外掛

### `Esc` : 拒絕建議（基礎）

Code Assist 中按 Esc 拒絕程式碼自動完成建議，或直接繼續輸入

僅適用於 Gemini Code Assist IDE 外掛

### `Ctrl+I / Cmd+I` : 快速選單（進階）

Code Assist 中開啟 Quick Pick 選單，輸入要對程式碼做的修改

VS Code 為 Ctrl+I（macOS 為 Cmd+I），JetBrains IDE 為 Alt+\（macOS 為 Cmd+\）

### `Ctrl+Enter / Control+Return` : 手動觸發（進階）

Code Assist 中手動觸發程式碼建議，不必等待自動提示

VS Code 鍵位（macOS 為 Control+Return），依官方說明可在 IDE 設定中自訂。JetBrains IDE 生成程式碼為 Alt+G（macOS 為 Option+G）

### `Shift+Tab` : Gemini CLI：切換核准模式（進階）

Gemini CLI 在 default、auto_edit、plan 三種核准模式間循環切換

### `Ctrl+Y` : Gemini CLI：YOLO 模式（隱藏）

Gemini CLI 開關 YOLO 模式，所有工具呼叫自動核准

依官方說明，啟動參數 --yolo 已標為淘汰，改用 --approval-mode=yolo

### `Ctrl+G` : Gemini CLI：外部編輯器（進階）

Gemini CLI 用外部編輯器開啟目前提示或計畫，適合撰寫長提示

## 🧩 Skills、Connected Apps 與 Gemini CLI（Skills, Connected Apps & Gemini CLI）

Gemini app 的 Gems、skills 與 Connected Apps（原 Extensions），以及 Gemini CLI 的 /、@、! 指令。依官方說明，個人帳號的 Gems 於 2026-11-17 起轉為唯讀、2026-12-17 移除並自動轉成 skills。Gemini CLI 自 2026-06-18 起不再服務免費個人與 Google AI Pro / Ultra 使用者（改用 Antigravity CLI），目前保留給 Gemini Code Assist 企業授權與付費 API 金鑰使用者

### `Gems` : 建立 Gem（基礎）

建立自訂的 Gemini 版本，設定名稱、指示與知識檔案，處理重複性任務

依官方說明，個人帳號的 Gems 於 2026-11-17 起轉為唯讀（不能使用、編輯或新建），2026-12-17 移除，並自動轉成 skills。Workspace 商用帳號 2027-03、教育帳號 2027-06 轉換

```
建立一個「翻譯助手」Gem，專門處理中英互譯
```

### `Gems Instructions` : 指令設定（進階）

撰寫 Gem 的指示，官方提供「Use Gemini to re-write instructions」可自動擴寫

本站建議用 Persona、Task、Context、Format 四段整理指示，這是寫法建議，不是官方規格

### `Gems Knowledge` : 知識檔案（進階）

在 Gem 的 Knowledge 區上傳檔案、從 Google Drive 加入檔案或加入 NotebookLM 筆記本，讓 Gem 參考

依官方說明，Drive 檔案會使用最近一次修改後的版本。轉成 skills 後，單一 skill 的檔案上限為 100 MB，部分檔案類型不支援

### `Gems Sharing` : 分享設定（基礎）

把 Gem 分享給特定人（檢視者或編輯者，可設到期日），或複製連結分享

依官方說明，個人帳號可把一般存取權設為公開或知道連結者皆可使用。Gem 內的指示與上傳檔案，任何能存取該 Gem 的人都看得到

### `/skill 名稱` : Skills（基礎）

在對話輸入 / 選擇 skill，讓 Gemini 套用可重複使用的自訂指示，也可同時疊用多個 skill

依官方說明，呼叫符號之後會改為 @。skills 目前可搭配 Connected Apps 使用，尚不支援 Canvas 與 Deep Research

### `@Gmail` : Gmail（基礎）

搜尋、摘要和分析 Gmail 郵件內容

屬於 Google Workspace 連接應用，輸入 @ 後選擇服務，需開啟 Keep Activity

```
@Gmail 幫我找上週來自 Amazon 的訂單確認信
```

### `@Google Drive` : Drive（基礎）

搜尋和分析 Google Drive 中的文件與檔案

屬於 Google Workspace 連接應用，輸入 @ 後選擇服務，需開啟 Keep Activity

```
@Google Drive 找到我的行銷提案簡報
```

### `@Google Docs` : Docs（基礎）

存取和分析 Google Docs 文件內容

屬於 Google Workspace 連接應用，輸入 @ 後選擇服務，需開啟 Keep Activity

### `@Google Calendar` : 行事曆（基礎）

查詢行事曆活動，也可請 Gemini 建立與管理活動

屬於 Google Workspace 連接應用，輸入 @ 後選擇服務，需開啟 Keep Activity

```
@Google Calendar 我明天有什麼會議？
```

### `@YouTube` : YouTube（基礎）

搜尋 YouTube 影片並整理影片內容重點

依官方說明，Gemini 會自動使用 YouTube 的公開資訊，不需另外連接，但需開啟 Keep Activity

```
@YouTube 找關於 Gemini API 的教學影片
```

### `@Google Maps` : Maps（基礎）

查詢路線、店家推薦與地點資訊

依官方說明，Gemini 會自動使用 Google Maps 的公開資訊，不需另外連接，但需開啟 Keep Activity

```
@Google Maps 從台北車站到信義區怎麼走？
```

### `Google Flights / Google Hotels` : 旅遊搜尋（基礎）

查詢航班與飯店資訊，協助規劃行程

依官方說明，Gemini 會自動使用 Google Flights 與 Google Hotels 的公開資訊，不需另外連接，但需開啟 Keep Activity。未經同意不會讀取你在這些服務的個人資料

```
幫我找下個月台北飛東京的機票
```

### `@Spotify` : Spotify（基礎）

在 Spotify 播放或搜尋音樂與 Podcast

依官方說明，僅支援 Gemini 行動應用程式，需個人 Google 帳號

### `@Google Photos` : Photos（基礎）

搜尋 Google Photos 中的相片、影片與回憶

依官方說明，需個人 Google 帳號、18 歲以上，僅特定國家與地區可連接

### `@Google Keep` : Keep（基礎）

建立與查詢 Google Keep 筆記與清單

屬於 Google Workspace 連接應用，輸入 @ 後選擇服務，需開啟 Keep Activity

### `@Google Tasks` : Tasks（基礎）

新增、編輯與查詢 Google Tasks 的工作與提醒

屬於 Google Workspace 連接應用，輸入 @ 後選擇服務，需開啟 Keep Activity

### `Custom apps (MCP)` : 自訂連接應用（進階）

輸入 MCP server 網址，把個人或第三方應用接到 Gemini，之後可在對話中用 @ 呼叫

依官方說明，目前限美國、18 歲以上、個人帳號、英文，需開啟 Keep Activity。Google 不監控第三方 MCP server

### `@GitHub` : 匯入 GitHub repo（進階）

在 Gemini 網頁版匯入 GitHub 儲存庫，詢問程式碼結構、函式用途或除錯

依官方說明，匯入後 repo 不會自動同步更新。單次最多一個 repo 或程式碼資料夾，上限 5,000 個檔案、100 MB

### `/help` : Gemini CLI：說明（基礎）

Gemini CLI 顯示所有可用指令與用法，也可輸入 /?

依官方說明，Gemini CLI 自 2026-06-18 起不再服務免費個人與 Google AI Pro / Ultra 使用者，這些使用者改用 Antigravity CLI。Gemini CLI 目前保留給 Gemini Code Assist Standard / Enterprise、Code Assist for GitHub 與付費 API 金鑰使用者

### `/init` : Gemini CLI：建立 GEMINI.md（基礎）

分析目前目錄並產生專案用的 GEMINI.md 情境檔，提供專案層級指示

### `/memory show | refresh | list` : Gemini CLI：記憶檔管理（進階）

查看、重新載入或列出目前使用中的 GEMINI.md 階層式記憶內容

### `/model set <model-name>` : Gemini CLI：切換模型（基礎）

設定 Gemini CLI 使用的模型，加 --persist 可保存設定，/model manage 開啟設定對話框

依官方說明，建議使用 Auto 讓系統自動選模型

### `/resume` : Gemini CLI：恢復對話（基礎）

開啟自動儲存的對話清單並接續，或用 save、resume、delete、share 子指令管理手動存檔（/chat 為同義指令）

### `/compress` : Gemini CLI：壓縮上下文（進階）

把整段對話換成摘要，節省之後任務的 token 用量

### `/rewind` : Gemini CLI：回溯對話（進階）

回到先前的對話節點，可選擇只回溯對話、只還原檔案變更或兩者都還原，快捷鍵為連按兩次 Esc

### `/mcp` : Gemini CLI：MCP 伺服器（進階）

列出已設定的 MCP 伺服器與工具，子指令包含 auth、enable、disable、reload、schema

### `/plan` : Gemini CLI：規劃模式（進階）

切換到唯讀的 Plan Mode 並查看目前計畫，/plan copy 可複製已核准的計畫

### `/stats` : Gemini CLI：用量統計（基礎）

顯示本次工作階段統計，/stats model 看各模型 token 與額度，/stats tools 看工具使用

### `@<路徑>` : Gemini CLI：引用檔案（基礎）

在提示中用 @ 加檔案或資料夾路徑，把內容帶入問題，預設會略過 git 忽略的檔案

```
@src/main.ts 說明這個檔案在做什麼
```

### `!<指令>` : Gemini CLI：執行 Shell（基礎）

用 ! 開頭直接在 Gemini CLI 中執行系統指令，單獨輸入 ! 可切換 shell 模式

依官方說明，shell 模式下的指令與直接在終端機執行有相同權限

## 📝 Gem / Skill 設定範例與實用情境（Gem & Skill Setups & Use Cases）

可直接複製的指示範例（Persona / Task / Context / Format 四段式），可貼進 Gem 或 skill 的指示欄，以及寫作、Coding、排程的提示詞情境

### `繁中文案編輯 Gem` : 設定範例（基礎）

把草稿改寫成可直接發佈的繁體中文文案，固定語氣與結構，不用每次重講一遍要求

把這四段整段貼進 Gem 的指令欄。之後只要丟草稿進去，不用再重述要求。依官方說明，個人帳號的 Gems 於 2026-11-17 起轉為 skills，這段指示可直接貼進 skill 的 instructions 欄。

```
【Persona 角色】
你是台灣的資深內容編輯，熟悉繁體中文寫作習慣與台灣讀者的閱讀節奏。

【Task 任務】
我會給你草稿，你要改寫成可直接發佈的版本。每次輸出前先問自己：讀者看完第一段會不會想繼續看？

【Context 背景】
讀者是一般上班族，不是專業人士。專有名詞第一次出現時保留英文原名並加上中文說明。
語氣專業但不生硬，不用「賦能」「顆粒度」這類詞。

【Format 輸出格式】
1. 改寫後全文
2. 「我改了什麼」條列 3 到 5 點，說明理由
不要加開場白，直接給改寫後的內容。
```

### `會議紀錄整理 Gem` : 設定範例（基礎）

把逐字稿或零散筆記整理成有負責人與期限的會議紀錄，重點是抓出待辦而不是流水帳

搭配 @Google Calendar 與 @Gmail 使用時，可以直接叫它去抓當天的會議邀請內容。依官方說明，個人帳號的 Gems 於 2026-11-17 起轉為 skills，這段指示可直接貼進 skill 的 instructions 欄。

```
【Persona 角色】
你是專案經理，負責把混亂的會議內容整理成別人看得懂的紀錄。

【Task 任務】
我會貼上逐字稿或零散筆記，你要整理成正式會議紀錄。
沒講到的事不要補，沒有結論的討論要標「未決」，不要幫忙下結論。

【Context 背景】
讀者是沒參加會議的同事，需要三分鐘內知道發生什麼事、自己要做什麼。

【Format 輸出格式】
一、決議事項（條列，每項標明負責人）
二、待辦事項（表格：事項 / 負責人 / 期限，期限沒講就寫「未定」）
三、未決議題（條列，附上分歧點）
四、下次會議需準備
```

### `技術文件翻譯 Gem` : 設定範例（基礎）

英翻中的技術文件，固定台灣用語與專有名詞處理方式，避免每次翻出中國用語

「不要用中國用語」寫成正反對照最有效，只寫「用台灣用語」模型常常抓不準。依官方說明，個人帳號的 Gems 於 2026-11-17 起轉為 skills，這段指示可直接貼進 skill 的 instructions 欄。

```
【Persona 角色】
你是台灣的技術文件譯者，翻譯對象是台灣的工程師與產品經理。

【Task 任務】
把我給的英文技術內容翻成繁體中文。
專有名詞保留英文原名，第一次出現時在後面加括號中文翻譯，之後直接用英文。

【Context 背景】
用台灣慣用詞，不要用中國用語：
軟體不要寫軟件、程式不要寫程序、資料不要寫數據、預設不要寫默認、專案不要寫項目。
不確定的術語直接保留英文，不要硬翻。

【Format 輸出格式】
直接給譯文，保留原文的標題層級與程式碼區塊。
如果有你判斷可能誤譯的地方，翻譯結束後另起一段「譯註」說明。
```

### `證照備考問答 Gem` : 設定範例（進階）

把讀書資料變成會反問你的家教，適合 iPAS 這類需要理解而非背誦的考試

搭配 Gem 或 skill 的檔案功能，把自己的筆記上傳進去，回答會貼著你的教材走。轉成 skill 後，單一 skill 檔案上限為 100 MB。依官方說明，個人帳號的 Gems 於 2026-11-17 起轉為 skills，這段指示可直接貼進 skill 的 instructions 欄。

```
【Persona 角色】
你是我的考試家教。你的目標不是給答案，是確認我真的懂。

【Task 任務】
我問問題時，先反問我一句，確認我卡在哪一層（名詞不懂 / 概念不懂 / 不會應用）。
確認後再解釋，解釋完出一題變化題讓我答。
我答錯時不要直接給正解，先指出我哪一步推錯。

【Context 背景】
我在準備 iPAS AI 應用規劃師。考題偏情境判斷，不是名詞解釋，所以請多用實際案例。
知識檔案裡是我整理的筆記，回答請優先引用裡面的內容。

【Format 輸出格式】
反問 → 解釋（三段內）→ 變化題
不要一次講完，等我回應再往下。
```

### `客戶回信 Gem` : 設定範例（基礎）

固定回信語氣與結構，處理難回的信時不會寫得太軟或太硬

最後那段「這封信的風險」是重點，讓它先幫你預想對方的反應。依官方說明，個人帳號的 Gems 於 2026-11-17 起轉為 skills，這段指示可直接貼進 skill 的 instructions 欄。

```
【Persona 角色】
你幫我草擬回信。我的角色是接案的專業服務提供者，不是客服。

【Task 任務】
我會貼上收到的信與我的立場，你草擬回信。
立場不能軟化。要拒絕的事就清楚拒絕，但不要道歉三次。
不要用「非常抱歉造成您的困擾」這種罐頭句。

【Context 背景】
收信人是客戶窗口，通常很忙。信要短，重點在前面。
如果我的立場會讓對方不高興，先寫一句同理，然後直接講結論，再講原因。

【Format 輸出格式】
主旨：
內文：（三段以內）
另外附一段「這封信的風險」，告訴我對方可能怎麼回。
```

### `程式碼審查 Gem` : 設定範例（進階）

固定審查順序與嚴格度，避免每次都只得到「看起來不錯」這種沒用的回覆

「預設立場是有問題」這句很關鍵，少了它模型傾向給肯定回覆。依官方說明，個人帳號的 Gems 於 2026-11-17 起轉為 skills，這段指示可直接貼進 skill 的 instructions 欄。

```
【Persona 角色】
你是嚴格的 code reviewer。你的預設立場是這段程式碼有問題，要找出來。

【Task 任務】
依這個順序看，不要跳：
1. 正確性：有沒有邏輯錯誤、邊界情況沒處理
2. 安全性：輸入驗證、權限檢查、機密資料外洩
3. 可維護性：命名、重複邏輯、過長函式
4. 效能：只在有實際瓶頸時才提

找不到問題就說「這三項沒發現問題」，不要為了有東西講而挑格式毛病。

【Context 背景】
這是要上正式環境的程式碼。我寧可被你罵，也不要上線才出事。

【Format 輸出格式】
每個問題一段：位置 / 為什麼是問題 / 具體會怎麼壞 / 建議改法
最後給一句總評：可以合併 / 要改完再合併 / 建議重寫
```

### `專業寫作輔助` : 文案寫作（基礎）

「請扮演資深編輯，將以下草稿改寫為語氣專業、架構清晰的文章，並在開頭加上引人入勝的 Hook。」

### `程式碼審查與開發` : Coding（進階）

「請審查這段 Python 程式碼的效能瓶頸，並提供使用 list comprehension 重構的範例，附上註解說明。」

### `會議排程與整理` : 排程整理（基礎）

「@Google Calendar @Gmail 幫我整理下週所有關於『行銷專案』的會議，並摘要每場會議的重點議程。」

### `在地化翻譯` : 翻譯情境（基礎）

「請將以下英文技術文件翻譯為繁體中文，語氣保持台灣科技社群的專業口吻，保留專有名詞原文。」

## ⚙️ 設定與個人化（Settings & Personalization）

記憶、Instructions for Gemini、活動紀錄與 Connected Apps 等個人化與隱私設定

### `Memory（Personal Intelligence）` : 記憶功能（基礎）

開啟後 Gemini 會參考過去對話來個人化回應，路徑為 Settings & help > Personal Intelligence > Memory

依官方說明，需 18 歲以上、個人帳號、開啟 Keep Activity，Gems 與 Live 對話不適用。要刪除記憶需刪除相關對話紀錄

### `「記住……」` : 請 Gemini 記住（基礎）

在對話中直接說「記住我吃素」，Gemini 會在之後的新對話中參考這項資訊，說錯時也可直接在對話中更正

依官方說明，記住個人資訊功能目前僅限美國、需 Google AI 方案

### `Instructions for Gemini` : 自訂指示（進階）

設定套用到每個對話的回應偏好，路徑為 Settings & help > Personal Intelligence > Instructions for Gemini > Add

依官方說明，所有使用者都可新增指示

```
「請用繁體中文回答，語氣專業但親切」
```

### `Keep Activity` : 活動管理（基礎）

在 Settings & help > Activity 查看或刪除 Gemini Apps 活動，也可關閉 Keep Activity

依官方說明，18 歲以上預設開啟。關閉後對話仍會保存最多 72 小時，且多數 Connected Apps 會無法使用

### `Auto-delete` : 自動刪除（基礎）

設定 Gemini Apps 活動自動刪除期間：3、18 或 36 個月，或選擇不自動刪除，預設為 18 個月

### `Connected Apps` : 已連接應用（基礎）

在側欄 Customize > Connectors 管理已連接的應用，可新增、中斷連線或查看支援動作

依官方說明，Connected Apps 原稱 Extensions，可用項目依 Gemini app、裝置、國家與帳號類型而不同

### `Import memory to Gemini` : 匯入其他 AI 記憶（進階）

在 Settings & help > Import memory to Gemini 取得提示詞，把其他 AI 平台的記憶帶進 Gemini

依官方說明，需 18 歲以上、個人帳號，EEA、瑞士與英國暫不提供

### `IDE Settings` : IDE 設定（進階）

Code Assist 的 IDE 外掛設定，控制行內建議等自動完成行為

依官方說明，VS Code 在 Settings > User > Extensions > Gemini Code Assist 調整

## 🎯 AI Studio 功能（Google AI Studio）

Google AI Studio 的 Playground、Run settings 與取得程式碼等功能

### `Prompt Gallery` : 提示範例頁（基礎）

瀏覽官方提示範例頁，點選後在 Google AI Studio 開啟並修改

官方頁面：ai.google.dev/gemini-api/prompts

### `System Instructions` : 系統提示（進階）

在 Run settings 的 System Instructions 欄設定模型的角色與行為規範

```
你是一位專業的台灣法律顧問，用繁體中文回答
```

### `Safety Settings (AI Studio)` : 內容篩選（基礎）

在 Run settings > Advanced settings > Safety settings 調整五類篩選：騷擾、仇恨言論、露骨色情、危險內容、越獄提示

依官方說明，Gemini 2.5 及之後的模型預設為關閉

### `Parameter Tuning` : 參數調整（基礎）

在 Run settings 調整 temperature、top-p、top-k 等生成參數，並開關結構化輸出、函數呼叫、程式碼執行與搜尋接地

依官方說明，temperature、topP、topK 在 Gemini 3.6 Flash 及更新模型會被忽略

### `Playground` : 即時測試（基礎）

開啟 AI Studio 預設進入 Playground，可即時測試提示詞並觀察模型回應

### `Get code` : 取得程式碼（基礎）

點 Get code 選擇程式語言，取得對應的 Gemini API 呼叫程式碼

### `Chat prompts` : 對話模式（基礎）

AI Studio 的對話提示，可多輪來回測試，系統指示在對話開始後仍可修改

## 🔧 API 參數（API Parameters）

Gemini API generateContent 的生成參數、安全設定與工具配置。依官方說明，目前 API 文件主軸為 Interactions API，generateContent 標示為 Legacy 但仍可使用

### `model` : 模型選擇（基礎）

指定 Gemini 模型 ID，例如目前的 gemini-3.8-flash（依官方說明，請以模型頁為準）

```
model: "gemini-3.8-flash"
```

### `generationConfig.temperature` : 隨機性（基礎）

控制生成的隨機性，範圍 0 到 2，越高越有變化

依官方說明，Gemini 3 建議維持預設 1.0，Gemini 3.6 Flash 及更新模型會忽略此參數

```
generationConfig: { temperature: 1.0 }
```

### `generationConfig.topP` : 核取樣（進階）

只從累積機率前 P 的 token 中取樣

依官方說明，Gemini 3.6 Flash 及更新模型會忽略此參數

```
generationConfig: { topP: 0.95 }
```

### `generationConfig.topK` : 前 K 取樣（進階）

只從機率最高的前 K 個 token 中取樣

依官方說明，Gemini 3.6 Flash 及更新模型會忽略此參數

```
generationConfig: { topK: 40 }
```

### `generationConfig.maxOutputTokens` : 最大輸出（基礎）

設定模型單次回應的最大輸出 token 數量上限

依官方說明，上限包含思考 token，觸頂會截斷輸出但思考 token 仍計費

```
generationConfig: { maxOutputTokens: 8192 }
```

### `generationConfig.candidateCount` : 候選數量（進階）

設定生成的候選回應數量，未設定時為 1

```
generationConfig: { candidateCount: 3 }
```

### `generationConfig.stopSequences` : 停止序列（進階）

設定最多 5 組停止字串，遇到即停止輸出，停止字串本身不會出現在回應中

```
generationConfig: { stopSequences: ["END", "---"] }
```

### `generationConfig.responseMimeType` : 回應格式（進階）

指定回應格式：application/json 輸出 JSON，text/x.enum 輸出列舉值，預設 text/plain

```
generationConfig: { responseMimeType: "application/json" }
```

### `generationConfig.responseJsonSchema` : JSON 結構（進階）

以 JSON Schema 限定模型輸出的 JSON 結構

需搭配 responseMimeType: "application/json"。依官方說明，舊欄位 responseSchema 已標示淘汰，建議改用 responseFormat

### `generationConfig.seed` : 隨機種子（進階）

設定解碼用的隨機種子，未設定時每次使用隨機值，可提高結果重現性

```
generationConfig: { seed: 42 }
```

### `generationConfig.presencePenalty` : 存在懲罰（進階）

懲罰已出現過的 token，正值讓模型使用更多樣的詞彙

依官方說明，這是開關式懲罰，與 token 出現次數無關，要隨次數加重請用 frequencyPenalty

```
generationConfig: { presencePenalty: 0.5 }
```

### `generationConfig.frequencyPenalty` : 頻率懲罰（進階）

依出現次數懲罰重複 token，減少內容重複

```
generationConfig: { frequencyPenalty: 0.5 }
```

### `thinkingConfig.thinkingBudget` : 思考預算（進階）

Gemini 2.5 系列用的思考 token 預算，設 -1 為動態思考，設 0 關閉思考（2.5 Pro 不可關閉）

依官方說明，2.5 Pro 範圍 128 到 32768，2.5 Flash 為 0 到 24576。Gemini 3 仍相容但建議改用 thinkingLevel，Gemini 4 已淘汰此參數，兩者同時送出會回 400

```
thinkingConfig: { thinkingBudget: 8192 }
```

### `thinkingConfig.thinkingLevel` : 思考級別（進階）

Gemini 3 及之後模型的思考深度：MINIMAL、LOW、MEDIUM、HIGH，各模型支援的等級與預設值不同

依官方說明，Gemini 2.5 不支援此參數，Gemini 4 Argon 無法關閉思考

```
thinkingConfig: { thinkingLevel: "low" }
```

### `safetySettings` : 安全設定（基礎）

各類別設定封鎖門檻：OFF、BLOCK_ONLY_HIGH、BLOCK_MEDIUM_AND_ABOVE、BLOCK_LOW_AND_ABOVE，未設定的類別預設關閉

```
safetySettings: [{ category: "HARM_CATEGORY_HARASSMENT", threshold: "BLOCK_MEDIUM_AND_ABOVE" }]
```

### `systemInstruction` : 系統指令（基礎）

API 層級的系統指令，定義模型全局行為與角色

```
systemInstruction: { parts: [{ text: "你是一位台灣旅遊專家" }] }
```

### `tools (google_search)` : 搜尋工具（基礎）

啟用 Google 搜尋工具，讓模型即時查詢網路資訊並附來源

```
tools: [{ google_search: {} }]
```

### `tools (code_execution)` : 程式碼執行（進階）

啟用程式碼執行工具，模型可寫並執行 Python 程式

```
tools: [{ code_execution: {} }]
```

### `tools (function_declarations)` : 函數呼叫（進階）

宣告可用函數讓模型決定何時呼叫，實現工具整合

```
tools: [{ function_declarations: [{ name: "get_weather", ... }] }]
```

### `tools (file_search)` : 檔案搜尋（進階）

從 File Search store 中語意檢索文件，官方的代管 RAG 方案

```
tools: [{ file_search: { file_search_store_names: ["fileSearchStores/..."] } }]
```

### `tools (url_context)` : 網址內容（進階）

啟用網址內容工具，讓模型讀取提示中提供的網址內容來回答

```
tools: [{ url_context: {} }]
```

### `tools (google_maps)` : 地圖接地（進階）

以 Google Maps 地理資訊作為回答依據，適合在地推薦與地點查詢

```
tools: [{ google_maps: {} }]
```

### `cachedContent` : 快取內容（進階）

引用預先建立的明確快取內容，快取讀取價格低於一般輸入，另計儲存費（依官方定價頁）

依官方說明，明確快取只能在 generateContent API 搭配支援的 Gemini 3 與 2.5 模型使用，Interactions API 與 Gemini 4 Argon 只支援隱式快取

```
cachedContent: "cachedContents/abc123"
```

### `ttl` : 快取存活（進階）

建立或更新快取時設定存活時間，未設定時預設 1 小時

```
ttl: "3600s"
```

### `responseModalities` : 回應模態（進階）

指定回應模態：TEXT、IMAGE、AUDIO，須符合模型支援的組合

```
generationConfig: { responseModalities: ["TEXT", "IMAGE"] }
```

### `generationConfig.imageConfig.imageSize` : 圖片尺寸（基礎）

設定生成圖片尺寸：512、1K、2K、4K，未設定時預設 1K（K 須大寫）

依官方說明，512 僅部分 Nano Banana 模型支援

```
imageConfig: { imageSize: "2K" }
```

### `generationConfig.imageConfig.aspectRatio` : 圖片比例（基礎）

設定生成圖片的長寬比，例如 1:1、3:2、4:3、16:9、9:16、21:9，各模型支援範圍不同

注意：aspectRatio 在 generationConfig.imageConfig 內，不是頂層

```
imageConfig: { aspectRatio: "16:9" }
```

### `generationConfig.mediaResolution` : 媒體解析度（進階）

設定輸入圖片與影片的解析度等級：LOW、MEDIUM、HIGH，影響 token 用量

```
generationConfig: { mediaResolution: "MEDIA_RESOLUTION_LOW" }
```

### `exclude_domains` : 排除網域（進階）

排除特定網域作為搜尋接地來源，避免不想要的資訊來源

依官方說明，此參數屬於 Gemini Enterprise Agent Platform（原 Vertex AI），Gemini Developer API 的 google_search 工具不支援

```
exclude_domains: ["example.com", "spam.net"]
```

## 🔬 進階功能（Advanced Features）

Deep Research、Gemini Live、Canvas、圖片與影片生成、排程動作等進階能力

### `Deep Research` : 深度研究（進階）

自動執行多步驟研究，彙整多個來源產生完整報告

依官方說明，Gemini app 需 18 歲以上，有每日次數與同時執行數上限。Gemini API 另有 Deep Research agent

```
「幫我深度研究台灣 AI 產業 2026 年趨勢」
```

### `Grounding with Google Search` : 搜尋接地（基礎）

將回應與 Google 搜尋結果連結，提供即時資訊與來源

依官方說明，Gemini 3 及之後模型的搜尋接地有每日請求上限與免費額度，詳見定價頁

### `Thinking` : 思考（進階）

Gemini 模型預設會動態思考，依問題難度自動調整推理量，可用 thinkingLevel（Gemini 3 之後）或 thinkingBudget（2.5）控制

### `Live API` : 即時互動（進階）

即時語音和視訊互動 API，支援雙向串流對話

依官方說明，Live API 支援 70 種語言對話

### `Gemini Live` : 語音對話（基礎）

在 Gemini app 用語音即時對話，可分享鏡頭或螢幕，也可在語音與文字模式間切換

### `Barge-in` : 語音中斷（基礎）

語音對話中可隨時打斷 Gemini，無需等待回答結束

Gemini app 可在 Live 設定中關閉「Interrupt Live responses」，關閉後仍可點螢幕打斷

### `Image Generation (Nano Banana)` : 圖片生成（基礎）

依官方說明，Gemini app 與 API 目前使用 Nano Banana 系列模型生成與編輯圖片，可多輪對話修改

依官方說明，Gemini app 生成圖片需 18 歲以上。Imagen 已停止服務

### `Conversational Editing` : 對話式編輯（進階）

用自然語言描述修改需求，在同一對話中多輪編輯已生成的圖片

```
「把背景改成海灘」「讓天空更藍」
```

### `Video generation (Omni)` : 影片生成（基礎）

用文字、圖片或影片當參考生成影片，可在同一對話多輪修改並選擇長寬比

依官方說明，個人帳號需 Google AI 方案、18 歲以上

### `Canvas` : Canvas（基礎）

在輸入框下方點 Add Files > Canvas，讓 Gemini 產出可直接編輯的文件、簡報、網頁或小程式

### `Scheduled actions` : 排程動作（進階）

請 Gemini 在指定時間定期執行任務，例如每天整理新聞摘要，結果會在排定時間前準備好

依官方說明，需開啟 Keep Activity，功能逐步開放中

### `Create a quiz / flashcards` : 測驗與單字卡（基礎）

輸入「Create a quiz about…」或「Create flashcards about…」，讓 Gemini 依主題或上傳教材產生測驗、單字卡與讀書指南

### `NotebookLM Integration` : NotebookLM（基礎）

在 Gemini app 上傳檔案時可加入 NotebookLM 筆記本，也能用筆記本產生 Audio Overview

### `Audio Overviews` : 音訊摘要（進階）

把文件、簡報或 NotebookLM 筆記本轉成雙人對談風格的音訊摘要

依官方說明，未滿 18 歲無法使用，生成通常需 3 到 5 分鐘

### `Code Assist` : 程式碼助手（基礎）

IDE 內建程式碼助手，提供自動完成、解釋與重構

### `Embeddings` : 多模態嵌入（進階）

依官方說明，目前 gemini-embedding-2 可把文字、圖片、影片、音訊與 PDF 轉為同一向量空間，用於語意搜尋、分類與 RAG

### `File Upload API` : 檔案上傳（基礎）

透過 Files API 上傳檔案供模型分析，單檔上限 2 GB

依官方說明，每專案上限 20 GB，檔案保存 48 小時。請求總大小超過 100 MB（PDF 為 50 MB）時須改用 Files API

### `Batch API` : 批次 API（進階）

以非同步方式批次處理請求，費用為標準價格的 50%，目標在 24 小時內完成

### `Context Caching` : 內容快取（進階）

Gemini 2.5 之後模型預設啟用隱式快取，命中自動折抵。另可在 generateContent API 建立明確快取，讀取價低於一般輸入，另計儲存費

依官方說明，隱式快取最低 token 數依模型為 2,048 或 4,096

### `Function Calling` : 函數呼叫（進階）

模型判斷適當時機呼叫預定義函數，串接外部服務

## 💰 模型與定價（Models & Pricing）

目前 Gemini API 的模型 ID、免費層級與計費方式（依官方模型頁與定價頁）

### `gemini-4-argon` : 旗艦推理（基礎）

依官方說明，目前列為旗艦推理模型，1M 上下文由輸入、思考與輸出共用，支援長輸出

依官方說明，不提供免費層級，無法關閉思考，只支援隱式快取

### `gemini-3.8-flash` : Flash 穩定版（基礎）

依官方說明，目前列為 Flash 穩定版，適合長流程軟體工程與代理任務

### `gemini-3.6-flash` : 上一代 Flash（基礎）

依官方說明，目前列為上一代 Flash 穩定版，兼顧速度與多模態

### `gemini-3.5-flash-lite` : Flash-Lite（基礎）

依官方說明，目前列為 3.5 系列速度最快、成本最低的模型，適合大量處理

### `gemini-3.1-pro-preview` : Pro 預覽版（基礎）

Gemini 3.1 Pro 預覽版，依官方說明目前為 Preview 模型，Gemini API 沒有免費層級

依官方說明，可在 Google AI Studio 免費試用

### `gemini-3.1-flash-lite` : 3.1 Flash-Lite（基礎）

Gemini 3.1 Flash-Lite 穩定版，依官方說明目前仍列於模型頁，適合低成本輕量任務

### `gemini-2.5-pro` : 2.5 Pro（基礎）

Gemini 2.5 系列的 Pro 模型，擅長複雜推理與程式

依官方說明，2.5 系列目前僅開放給過去曾使用者，未淘汰，新專案建議改用 3.5 Flash-Lite 或 3.8 Flash

### `gemini-2.5-flash` : 2.5 Flash（基礎）

Gemini 2.5 系列的 Flash 模型，支援思考預算與 1M 上下文

依官方說明，2.5 系列目前僅開放給過去曾使用者，未淘汰，新專案建議改用 3.5 Flash-Lite 或 3.8 Flash

### `gemini-2.5-flash-lite` : 2.5 Flash-Lite（基礎）

Gemini 2.5 系列的輕量多模態模型，預設不思考

依官方說明，2.5 系列目前僅開放給過去曾使用者，未淘汰，新專案建議改用 3.5 Flash-Lite 或 3.8 Flash

### `gemini-embedding-2` : 嵌入模型（進階）

依官方說明，目前的多模態嵌入模型預設輸出 3072 維，可用 output_dimensionality 縮減，官方建議 768、1536 或 3072

純文字用途可用 gemini-embedding-001

### `Free Tier` : 免費層級（基礎）

免費層級可用部分模型，速率上限依模型與專案而定，可在 AI Studio 查看目前額度

依官方說明，免費層級的內容會用於改善產品，付費層級不會。Gemini 4 Argon 不提供免費層級

### `Pay-as-you-go` : 按量計費（基礎）

依實際使用的 token 數量收費，無固定月費

依官方定價頁，價格依模型與輸入長度不同，部分模型已公告調價日期，請以定價頁為準

### `Context Window` : 上下文視窗（基礎）

Gemini API 多數模型提供 1M token 上下文。Gemini app 則依方案而定：免費 32k、AI Plus 128k、AI Pro 與 Ultra 為 1M

依官方說明，Gemini 4 Argon 的 1M 由輸入、思考與輸出共用，Gemini 3 與 2.5 為 1M 輸入、64K 輸出

## 💡 進階技巧（Power User Tips）

較少人注意、但官方文件有寫的用法與省成本技巧

### `Gemini Live 鏡頭分享` : 鏡頭辨識（隱藏）

在 Live 對話中開啟鏡頭，讓 Gemini 看到眼前的物品並即時討論

### `1M Token Context` : 超長上下文（隱藏）

利用 1M token 上下文分析大量對話紀錄或超長文件

API 多數模型為 1M。依官方說明，Gemini app 需 AI Pro 或 Ultra 方案才有 1M

```
上傳一整年的客服對話紀錄，請 Gemini 分析趨勢
```

### `Implicit Caching` : 提高快取命中（隱藏）

把大量固定內容放在提示開頭，並在短時間內送出相同前綴的請求，提高隱式快取命中率

### `thinkingBudget: -1` : 動態思考（隱藏）

設定 thinkingBudget 為 -1，讓模型自動調整思考深度

僅適用 Gemini 2.5 系列，Gemini 3 之後請改用 thinkingLevel

### `Multi-App Synthesis` : 跨應用整合（隱藏）

用 @ 指定 Google Workspace 中的多個服務，讓 Gemini 一次整理 Gmail、Calendar、Drive 的資訊

```
「下週會議前幫我整理相關郵件和 Drive 文件」
```

### `Google Maps 組合查詢` : 組合查詢（隱藏）

一句話同時問路線與沿途地點，例如沿途評價高的餐廳

依官方說明，Gemini 會自動使用 Google Maps 公開資訊，需開啟 Keep Activity

```
「從台北到高雄的路線，沿途評價高的餐廳」
```

### `Gemini CLI model routing` : 模型備援（隱藏）

Gemini CLI 在模型失敗（例如額度或伺服器錯誤）時，會詢問是否切換到備援模型

### `Aspect Ratio 1:8 / 8:1` : 極端比例（隱藏）

生成 1:8、1:4、4:1、8:1 這類超長或超寬比例的圖片

依官方說明，這些比例僅部分 Nano Banana 模型支援

---
來源：AITerms.tw | https://aiterms.tw/cheatsheet/gemini