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:在复杂的智能体和多模态 任务方面表现更强,同时减少了 token 使用量,且价格低于 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 |
$1.50/百万输入 token,$7.50/百万输出 token | 在智能体和多模态任务方面兼顾速度和智能。 |
| Gemini 3.5 Flash-Lite | gemini-3.5-flash-lite |
minimal |
$0.30/百万输入 token,$2.50/百万输出 token | 速度最快、成本最低的 3.5 模型,适用于高吞吐量执行。 |
这两种模型都支持 100 万个 token 的上下文窗口、最多 64,000 个输出 token、 思考功能以及包括 “计算机使用”在内的全套内置工具。
如需查看完整规范,请参阅模型页面:
如需了解详细价格,请参阅价格页面。
快速入门
Python
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)
JavaScript
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.outputText);
}
main();
REST
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": "Write a three.js script that renders an interactive 3D robot."
}'
Gemini 3.6 Flash 的新功能
- 减少 token 和轮次 :与 Gemini 3.5 相比,完成多步骤工作流所需的推理步骤、对话轮次和工具调用更少。它还减少了执行循环螺旋。
- 改进了代码生成 :生成更高质量的可用于生产用途的代码,减少了不必要的修改和调试循环。
- 更好地遵循指令:减少了诊断任务期间不必要的文件更改。
- 强大的多模态和空间推理能力 :在图表解读、视觉蓝图转换和多元素网页布局生成方面表现更佳。
- 预先进行程序化检查 :与 Gemini 3.5 Flash 相比,更倾向于在进行更改之前运行诊断代码脚本。这提高了复杂任务的准确性,但可能会在日常前端工作中增加额外的探索步骤。
- 支持“计算机使用” :作为智能体界面自动化的内置工具提供支持。
- 界面样式偏好:更擅长创建功能性代码,但人工评估人员更喜欢早期模型中的图文并茂和样式。您可以通过提供明确的设计指南来缓解此问题。
- 默认思考力度(中等) :使用与 Gemini 3.5 Flash 相同的
medium默认思考等级。 - 降低了价格:降低了输出 token 费用(7.50 美元/百万 token,而 3.5 Flash 为 9.00 美元/百万 token)。输入 token 仍为 1.50 美元/百万 token。
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 相比,多轮指令遵循和角色一致性更强。
- 支持“计算机使用” :作为智能体界面自动化的内置工具提供支持。
选择合适的 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-Litegemini-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. 预填模型轮次验证
不允许以非空模型角色轮次结尾的 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 */
]
}
✅ 推荐的迁移方式 (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.",
)
迁移核对清单
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")。 - 审核函数调用
- 将多模态素材资源放在响应载荷内。
- 使用
\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 中测试和优化提示。