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:在复杂的智能体和多模态任务上具有更强的性能,同时减少 token 的使用,价格比 3.5 Flash更低。
- Gemini 3.5 Flash-Lite:3.5 系列中速度最快、成本最低的型号。在高吞吐量执行方面优于前几代 Flash-Lite。
本指南解释了每个模型中引入的内容、API 的哪些更改会影响您的代码以及如何迁移。
- 安装技能:
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global
- 应用技能:
/gemini-interactions-api migrate my app to 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.5 Flash-Lite
新型号 #
| 模型 | 型号编号 | 默认思维水平 | 价格 | 说明 |
|---|---|---|---|---|
| Gemini 3.6 Flash | gemini-3.6-flash | medium | $1.50/1M 输入 token 和 $7.50/1M 输出 token | 在智能体和多模态任务中平衡速度与智能。 |
| Gemini 3.5 Flash-Lite | gemini-3.5-flash-lite | minimal | $0.30/1M 输入 token 和 $2.50/1M 输出 token | 速度最快、成本最低的 3.5 型号,可实现高吞吐量执行。 |
两种型号均支持 1M token 上下文窗口、64k 最大输出 token、思维以及全套内置工具,包括 电脑使用.
有关完整规格,请参阅型号页面:
详细定价请参见 定价页面.
快速入门 #
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 的新增功能 #
- token和回合减少: 与 Gemini 3.5. 相比,以更少的推理步骤、对话轮次和工具调用完成多步骤工作流。它还减少了执行循环螺旋。
- 改进的代码生成: 生成更高质量的生产就绪代码,减少不必要的编辑和调试循环。
- 更好地遵循指导:减少诊断任务期间不需要的文件更改。
- 强大的多模态和空间推理: 改进了图表解释、视觉蓝图转换和多元素 Web 布局生成的性能。
- 预先程序化检查: 与 Gemini 3.5 Flash 相比,更喜欢在进行更改之前更频繁地运行诊断代码脚本。这提高了复杂任务的准确性,但可以在日常前端工作中添加额外的探索步骤。
- 计算机使用支持: 作为智能体 UI 自动化的内置工具提供支持。
- UI 样式偏好:更擅长创建功能代码,尽管人类评估者更喜欢早期的视觉布局和样式模型。您可以通过提供明确的设计指南来缓解这种情况。
- 默认思维努力(中): 用途相同
medium默认思维级别为Gemini 3.5 Flash。 - 降低价格:较低的输出 token 成本($7.50/1M 与 $9.00/1M 对于 3.5 Flash)。输入 token 保留在 $1.50/1M。
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 更强的多轮指令跟随和角色一致性。
- 计算机使用支持: 作为智能体 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(预览版), 或 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 引入了对 Antigravity 智能体 在 Gemini 托管智能体中。
有关当前代码示例和最新的默认智能体配置,请参阅 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. 采样参数弃用(温度、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.",
)
迁移清单 #
- 安装技能:
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global
- 应用技能:
/gemini-interactions-api migrate my app to 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.5 Flash-Lite
迁移到 gemini-3.6-flash #
更新型号 ID: Change your target model string to
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: Change your target model string to
gemini-3.5-flash-lite.配置思考努力水平: * 对于大容量提取、路由或分类:保留
thinking_level在"minimal"(默认)以获得最大吞吐量。- 对于具有工具调用、代码执行或多步推理的自治子智能体:设置
thinking_level到"medium"或"high"以防止工具过早终止。
- 对于具有工具调用、代码执行或多步推理的自治子智能体:设置
删除已弃用的参数并验证函数调用: 应用 与3.6 Flash相同的规则.
基线 Gemini 3.x 要求: 参考 思考签名.
其他型号 #
后续步骤 #
- 查看 API 规格 型号概览.
- 探索多智能体编排 Interactions API指南.
- 测试并完善提示 Google AI Studio.