Gemini 中文指南
获取 API 密钥 ↗

Gemini 3.6 Flash 与 3.5 Flash-Lite 新特性

↓ 下载 Markdown

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 的哪些更改会影响您的代码以及如何迁移。

  1. 安装技能:
bash
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global
  1. 应用技能:
bash
/gemini-interactions-api migrate my app to Gemini 3.6 Flash

新型号 #

模型型号编号默认思维水平价格说明
Gemini 3.6 Flashgemini-3.6-flashmedium$1.50/1M 输入 token 和 $7.50/1M 输出 token在智能体和多模态任务中平衡速度与智能。
Gemini 3.5 Flash-Litegemini-3.5-flash-liteminimal$0.30/1M 输入 token 和 $2.50/1M 输出 token速度最快、成本最低的 3.5 型号,可实现高吞吐量执行。

两种型号均支持 1M token 上下文窗口、64k 最大输出 token、思维以及全套内置工具,包括 电脑使用.

有关完整规格,请参阅型号页面:

详细定价请参见 定价页面.

快速入门 #

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)

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 智能体支持 #

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 错误。 从所有请求中删除这些参数。

python
# ⚠️ Remove these parameters (deprecated)
generation_config = {
     "temperature": 0.7,
     "top_p": 0.9,
     "top_k": 40,
}

为了提高确定性,请为您的特定用例定义具有明确规则的系统指令。

2. 预填充模型转向验证 #

以非空模型角色回合结束的 API 请求将被禁止并返回 HTTP 400 错误.

⚠️避免 #

遗产中 generateContent 现在不允许以模型角色转变结束的原始 REST 有效负载:

json
/* ❌ 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 或 结构化输出 相反。

python
# ✅ 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."},
)

迁移清单 #

  1. 安装技能:
bash
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global
  1. 应用技能:
bash
/gemini-interactions-api migrate my app to Gemini 3.6 Flash

迁移到 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").

  • 审核函数调用: * 确保所有 FunctionResponse 对象包括 call_id 和 name.

    • 将多模态资产放置在响应负载中。
    • 使用格式化内联指令 \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 名称或正文内容