Gemini 3.6 Flash 與 3.5 Flash-Lite 的新功能¶
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 變更,以及遷移方式。
你可以使用支援 skills 的程式設計代理(例如 Antigravity)自動完成這項遷移。
-
安裝 skill:
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global -
套用 skill:
/gemini-interactions-api migrate my app to Gemini 3.6 Flash
-
安裝 skill:
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global -
套用 skill:
/gemini-interactions-api migrate my app to Gemini 3.5 Flash-Lite
新模型¶
| 模型 | 模型 ID | 預設思考層級 | 定價 | 說明 |
|---|---|---|---|---|
| Gemini 3.6 Flash | gemini-3.6-flash |
medium |
輸入權杖每 1M $1.50、輸出權杖每 1M $7.50 | 在速度與智慧之間取得平衡,適合代理與多模態任務。 |
| Gemini 3.5 Flash-Lite | gemini-3.5-flash-lite |
minimal |
輸入權杖每 1M $0.30、輸出權杖每 1M $2.50 | 速度最快、成本最低的 3.5 模型,適合高輸送量執行。 |
這兩個模型都支援 1M 權杖上下文視窗、64k 輸出權杖上限、思考功能,以及包含 Computer Use 在內的整套內建工具。
如需完整規格,請參閱模型頁面:
如需詳細定價,請參閱定價頁面。
快速入門¶
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-3.6-flash",
input="Write a three.js script that renders an interactive 3D robot."
)
print(interaction.output_text)
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({});
async function main() {
const interaction = await ai.interactions.create({
model: "gemini-3.6-flash",
input: "Write a three.js script that renders an interactive 3D robot.",
});
console.log(interaction.output_text);
}
await main();
curl "https://generativelanguage.googleapis.com/v1beta/interactions" -H "x-goog-api-key: $GEMINI_API_KEY" -H 'Content-Type: application/json' -X POST -d '{
"model": "gemini-3.6-flash",
"input": {
"parts": [{"text": "Write a three.js script that renders an interactive 3D robot."}]
}
}'
Gemini 3.6 Flash 的新功能¶
- 減少權杖與回合數:以更少的推理步驟、對話回合與工具呼叫完成多步驟工作流程,表現優於 Gemini 3.5。同時也能減少執行迴圈失控打轉的情況。
- 改善程式碼產生:產生品質更高、可直接用於正式環境的程式碼,減少不必要的修改與除錯迴圈。
- 更佳的指令遵循能力:在診斷任務中減少不必要的檔案變更。
- 強大的多模態與空間推理:在圖表解讀、視覺藍圖轉換與多元素網頁版面產生上,效能有所提升。
- 預先進行程式化檢查:比 Gemini 3.5 Flash 更常在修改前先執行診斷程式碼指令碼。這能提升複雜任務的正確率,但在例行的前端工作上,可能會增加額外的探索步驟。
- Computer Use 支援:支援作為內建工具,用於代理式 UI 自動化。
- UI 樣式偏好:更擅長建立功能完整的程式碼,不過人類評測人員在視覺版面與樣式方面較偏好先前的模型。你可以提供明確的設計準則來緩解這個問題。
- 預設思考投入(medium):採用與 Gemini 3.5 Flash 相同的
medium預設思考層級。 - 價格調降:輸出權杖成本降低(每 1M 為 $7.50,3.5 Flash 為 $9.00)。輸入權杖維持每 1M $1.50。
Gemini 3.5 Flash-Lite 的新功能¶
- 降低任務執行延遲:在 3.5 家族中輸送量最高,適合大量資料解析與文件擷取。
- 強化推理與多模態效能:是從 Gemini 2.5 Flash 遷移的理想路徑,在 HLE 等推理任務(18.0% 對 11.0%)與 CharXIV 等多模態評測基準(74.5% 對 63.7%)上都取得更高分數。
- 子代理協作與工具可靠性:提升程式碼執行、搜尋與 MCP 工作流程的工具執行可靠性。若是自主規劃與複雜的子代理任務,請提高思考層級。
- 改善文件理解能力:提升文件解析與結構化資料擷取的正確率。請依文件複雜程度,分別嘗試 minimal 與 high 思考層級。
- 互動式網頁程式設計與表格式資料處理:透過輕量程式碼執行進行規劃,在前端 JavaScript 與表格式資料處理上表現出色。
- 聊天機器人與角色一致性:相較於 Gemini 3.1 Flash-Lite,多回合指令遵循與角色一致性更強。
- Computer Use 支援:支援作為內建工具,用於代理式 UI 自動化。
選擇合適的 Flash 或 Flash-Lite 模型¶
請使用下表,為你的工作負載選擇合適的模型與遷移路徑。
這兩個模型都必須移除已淘汰的取樣參數(temperature、top_p、top_k)與預填的模型回合。詳情請參閱 API 變更。
| 模型 | 主要用途 | 建議遷移目標 |
|---|---|---|
Gemini 3.6 Flash (gemini-3.6-flash) |
程式碼產生、空間/多模態推理、多步驟代理工作流程 | Gemini 3.5 Flash、Gemini 3 Flash (Preview) 或 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 代理支援¶
Gemini 3.6 Flash 在 Gemini Managed Agents 中導入了 Antigravity 代理 的支援。
如需目前的程式碼範例與最新的預設代理設定,請參閱 Antigravity 代理指南 與 Gemini 3.8 Flash 指南。
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. 預填模型回合驗證¶
以非空白的 model 角色回合結尾的 API 要求不受允許,會傳回 HTTP 400 Error。
⚠️ 避免¶
在舊版 generateContent 或原始 REST 酬載中,以 model 角色回合結尾的做法現在已不受允許:
/* ❌ 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 */
]
}
✅ 建議的遷移方式(Interactions API)¶
在 Interactions API 中,模型回合不會以手動方式預填。如果你的應用程式先前曾預填模型回合,以抑制前言或強制 JSON 格式,請改用 system_instruction 或結構化輸出。
# ✅ RECOMMENDED: Use system_instruction in the Interactions API to specify output format
interaction = client.interactions.create(
model="gemini-3.6-flash",
input="Translate 'Hello world' to Spanish.",
system_instruction="Output only the translation without introductory text.",
)
遷移檢查清單¶
你可以使用支援 skills 的程式設計代理(例如 Antigravity)自動完成這項遷移。
-
安裝 skill:
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global -
套用 skill:
/gemini-interactions-api migrate my app to Gemini 3.6 Flash
-
安裝 skill:
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global -
套用 skill:
/gemini-interactions-api migrate my app to Gemini 3.5 Flash-Lite
遷移至 gemini-3.6-flash¶
- 更新 Model ID:將目標模型字串改為
gemini-3.6-flash。 - 套用參數更新:移除已淘汰的取樣參數(
temperature、top_p、top_k)、candidate_count(Gemini 3 及後續版本不支援),以及預填的模型回合,詳情請參閱 API 變更與參數更新。 - 設定思考層級:將
thinking_budget改為thinking_level("medium"或"high")。 - 稽核函式呼叫:
- 將多模態素材放在回應酬載內。
- 使用
\n\n格式化行內指令。 -
如果你看到與工具前文字相關的
Malformed_Function_Call錯誤,請參閱工具前文字需求的因應方式。 -
Gemini 3.x 基本要求:如需 SDK 更新與思考簽章保留的相關資訊,請參閱思考簽章。
遷移至 gemini-3.5-flash-lite¶
- 更新 Model ID:將目標模型字串改為
gemini-3.5-flash-lite。 - 設定思考投入層級:
- 若是大量擷取、路由或分類:將
thinking_level維持在"minimal"(預設),以獲得最高輸送量。 -
若是會進行工具呼叫、程式碼執行或多步驟推理的自主子代理:將
thinking_level設為"medium"或"high",以避免工具過早終止。 -
移除已淘汰的參數並驗證函式呼叫:套用與 3.6 Flash 相同的規則。
- Gemini 3.x 基本要求:請參閱 思考簽章。
其他模型¶
後續步驟¶
- 在 Models Overview 查閱 API 規格。
- 在 Interactions API 指南 探索多代理協作。
- 在 Google AI Studio 測試並優化提示詞。