Gemini 3.6 Flash (gemini-3.6-flash) 和 Gemini 3.5 Flash-Lite (gemini-3.5-flash-lite) 是 Gemini 3 系列的上一代版本,仍可用於正式環境。如要瞭解最新的 Flash 模型,請參閱 Gemini 3.8 Flash。
- Gemini 3.6 Flash:處理複雜的代理式和多模態工作時,效能更強大,同時減少詞元用量,價格也比 3.5 Flash 低。
- Gemini 3.5 Flash-Lite:3.5 系列中速度最快、成本最低的模型。 執行高處理量工作時,效能優於先前的 Flash-Lite 版本。
本指南將說明各個模型推出的功能、影響程式碼的 API 異動,以及遷移方式。
Gemini 3.6 Flash
安裝技能:
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global套用技能:
/gemini-interactions-api migrate my app to Gemini 3.6 Flash
Gemini 3.5 Flash-Lite
安裝技能:
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global套用技能:
/gemini-interactions-api migrate my app to Gemini 3.5 Flash-Lite
全新模型
| 模型 | 模型 ID | 預設思考程度 | 定價 | 說明 |
|---|---|---|---|---|
| Gemini 3.6 Flash | gemini-3.6-flash |
medium |
每 100 萬個輸入權杖 $1.50 美元,每 100 萬個輸出權杖 $7.50 美元 | 兼顧速度與智慧,適合代理式和多模態工作。 |
| Gemini 3.5 Flash-Lite | gemini-3.5-flash-lite |
minimal |
每 100 萬個輸入權杖 $0.30 美元,每 100 萬個輸出權杖 $2.50 美元 | 速度最快、成本最低的 3.5 模型,適合高處理量執行作業。 |
這兩款模型都支援 100 萬個詞元的脈絡窗口、6.4 萬個輸出詞元上限、思考功能,以及 Computer Use 等全套內建工具。
如需完整規格,請參閱模型頁面:
如需詳細定價資訊,請參閱定價頁面。
快速入門導覽課程
Python
from google import genai
client = genai.Client()
response = client.models.generate_content(
model="gemini-3.6-flash",
contents="Write a three.js script that renders an interactive 3D robot.",
)
print(response.text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({});
async function main() {
const response = await ai.models.generateContent({
model: "gemini-3.6-flash",
contents: "Write a three.js script that renders an interactive 3D robot.",
});
console.log(response.text);
}
main();
REST
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.6-flash:generateContent" -H "x-goog-api-key: $GEMINI_API_KEY" -H 'Content-Type: application/json' -X POST -d '{
"contents": [{
"parts": [{"text": "Write a three.js script that renders an interactive 3D robot."}]
}]
}'
Gemini 3.6 Flash 新功能
- 減少詞元和對話輪數:與 Gemini 3.5 相比,完成多步驟工作流程所需的推論步驟、對話輪數和工具呼叫次數更少。並減少執行迴圈螺旋。
- 提升程式碼生成品質:生成可直接用於正式環境的程式碼,減少不必要的編輯和偵錯迴圈。
- 更準確地遵循指示:減少診斷工作期間不必要的檔案變更。
- 強大的多模態和空間推理能力:提升圖表解讀、視覺藍圖轉換,以及多元素網頁版面配置生成等方面的效能。
- 預先程式化檢查:相較於 Gemini 3.5 Flash,更常在變更前執行診斷程式碼指令碼。這可提高複雜工作的準確度,但可能會增加例行前端工作的探索步驟。
- 電腦使用支援:支援做為代理 UI 自動化的內建工具。
- UI 樣式偏好:更擅長建立功能性程式碼,但人類評估人員偏好早期模型的視覺版面配置和樣式。您可以提供明確的設計指南,降低這類風險。
- 預設思考強度 (中):使用與 Gemini 3.5 Flash 相同的
medium預設思考強度。 - 價格更低:輸出詞元費用更低 (每 100 萬個詞元 $7.50 美元,3.5 Flash 則為 $9.00 美元)。輸入權杖的價格仍為每 100 萬個 $1.50 美元。
Gemini 3.5 Flash-Lite 最新消息
- 縮短工作執行延遲時間:3.5 系列中處理量最高,適合大量資料剖析和文件擷取。
- 強化推論和多模態效能:從 Gemini 2.5 Flash 遷移至此模型,可大幅提升效能,在 HLE 等推論任務 (18.0% 對比 11.0%) 和 CharXIV 等多模態基準測試 (74.5% 對比 63.7%) 取得更高分數。
- 子代理自動化調度管理和工具可靠性:提升執行程式碼、搜尋和 MCP 工作流程的工具執行可靠性。提高思考等級,以便自主規劃及處理複雜的子代理工作。
- 提升文件理解能力:提升文件剖析和結構化資料擷取的準確度。視文件複雜度,嘗試使用最低和最高思考程度。
- 互動式網頁程式設計和表格型資料處理:使用輕量程式碼執行作業進行規劃,在前端 JavaScript 和表格型資料處理方面表現出色。
- 聊天機器人和角色設定持久性:相較於 Gemini 3.1 Flash-Lite,Gemini 3.1 Flash 遵循多輪指令的能力更強,角色設定也更一致。
- 電腦使用支援:支援做為代理 UI 自動化的內建工具。
選擇合適的 Flash 或 Flash-Lite 模型
請參閱下表,為工作負載選擇合適的模型和遷移路徑。
這兩個模型都需要移除已淘汰的取樣參數 (temperature、top_p、top_k) 和預填模型輪次。詳情請參閱「API 變更」。
| 模型 | 主要用途 | 建議的遷移目標 |
|---|---|---|
Gemini 3.6 Flashgemini-3.6-flash |
程式碼生成、空間/多模態推論、多步驟 Agentic Workflows | Gemini 3.5 Flash、Gemini 3 Flash (預先發布版)或 Gemini 3.1 Pro |
Gemini 3.5 Flash-Lite gemini-3.5-flash-lite |
自主執行子代理程式、大量資料分析和文件擷取、結構化 JSON 剖析 | Gemini 3.1 Flash-Lite 或 Gemini 2.5 Flash |
Antigravity 代理程式支援
API 變更和參數更新
從 Gemini 3.6 Flash 和 Gemini 3.5 Flash-Lite 開始,下列 API 異動適用於這些模型,以及日後推出的所有 Gemini 模型。
- 淘汰取樣參數:
temperature、top_p和top_k已淘汰。API 會忽略這些參數,並在日後產生模型時傳回錯誤。 - 預填模型輪次驗證:系統不再支援預填模型輪次。如果要求中最後一個非空白的輪替是
model輪替,API 會傳回400錯誤。
以下各節將詳細說明各項 API 異動,並提供程式碼範例。
1. 取樣參數已淘汰 (temperature、top_p、top_k)
temperature、top_p 和 top_k 已淘汰並遭到忽略。在未來的模型世代中,提供這些參數會傳回 HTTP 400 錯誤。從所有要求中移除這些參數。
# ⚠️ Remove these parameters (deprecated)
generation_config = {
"temperature": 0.7,
"top_p": 0.9,
"top_k": 40,
}
如要提升確定性,請根據特定用途定義系統指令,並加入明確規則。
2. 預填模型輪次驗證
API 要求結尾不得為非空白的模型角色對話,否則會傳回 HTTP 400 錯誤。
⚠️ 避免
在舊版 generateContent 或原始 REST 酬載中,現在不允許以模型角色輪次結尾:
/* ❌ DO NOT: End payload contents with a 'model' role turn */
{
"contents": [
{"role": "user", "parts": [{"text": "Translate 'Hello world' to Spanish."}]},
{"role": "model", "parts": [{"text": "Translation:"}]} /* ❌ Returns error */
]
}
✅ 建議遷移
如果應用程式先前會預填模型對話,以隱藏前導提示或強制使用 JSON 格式,請改用 system_instruction 或結構化輸出。
# ✅ RECOMMENDED: Use system_instruction to specify output format
response = client.models.generate_content(
model="gemini-3.6-flash",
contents="Translate 'Hello world' to Spanish.",
config={"system_instruction": "Output only the translation without introductory text."},
)
遷移工作檢查清單
Gemini 3.6 Flash
安裝技能:
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global套用技能:
/gemini-interactions-api migrate my app to Gemini 3.6 Flash
Gemini 3.5 Flash-Lite
安裝技能:
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global套用技能:
/gemini-interactions-api migrate my app to Gemini 3.5 Flash-Lite
遷移至 gemini-3.6-flash
- 更新模型 ID:將目標模型字串變更為
gemini-3.6-flash。 - 套用參數更新:移除已淘汰的取樣參數 (
temperature、top_p、top_k)、candidate_count(Gemini 3 以上版本不支援),以及預先填入的模型輪流,詳情請參閱「API 異動和參數更新」。 - 設定思考程度:將
thinking_budget替換為thinking_level("medium"或"high")。 - 稽核函式呼叫:
- 確認所有
FunctionResponse物件都包含call_id和name。 - 將多模態素材資源放入回覆酬載。
- 使用
\n\n格式化內嵌指令。 - 如果看到與工具前文字相關的
Malformed_Function_Call錯誤,請參閱「工具前文字規定的解決方法」。
- 確認所有
- Gemini 3.x 基本需求:如要瞭解 SDK 更新和保留思考簽章,請參閱「思考簽章」。
遷移至 gemini-3.5-flash-lite
- 更新模型 ID:將目標模型字串變更為
gemini-3.5-flash-lite。 - 設定思考深度等級:
- 如要大量擷取、轉送或分類:請將
thinking_level設為"minimal"(預設),以達到最大處理量。 - 如果自主子代理會呼叫工具、執行程式碼或進行多步驟推論,請將
thinking_level設為"medium"或"high",以免工具過早終止。
- 如要大量擷取、轉送或分類:請將
- 移除已淘汰的參數並驗證函式呼叫:套用與 3.6 Flash 相同的規則。
- Gemini 3.x 基本需求:請參閱「思考簽章」。
其他模型
後續步驟
- 在「模型總覽」中查看 API 規格。
- 請參閱 Interactions API 指南,瞭解多代理自動化調度管理。
- 在 Google AI Studio 測試及調整提示。