使用最新的 Gemini 模型

本页面介绍了 3.5 Flash

Gemini 3.6 Flash (gemini-3.6-flash) 和 Gemini 3.5 Flash-Lite (gemini-3.5-flash-lite) 现已正式发布 (GA)，可用于生产环境。

• Gemini 3.6 Flash：在处理复杂的智能体任务和多模态任务时性能更强，同时减少了 token 使用量，且价格低于 3.5 Flash。
• Gemini 3.5 Flash-Lite：3.5 系列中速度最快、成本最低的模型。在执行高吞吐量任务时，性能优于之前的 Flash-Lite 版本。

本指南介绍了每个模型的新功能、哪些 API 变更会影响您的代码，以及如何进行迁移。

新模型

这两种模型都支持 100 万个 token 的上下文窗口、最多 64,000 个输出 token、思考功能以及全套解决方案（包括 “计算机使用”）。

如需查看完整规范，请参阅模型页面：

• Gemini 3.6 Flash 模型页面
• Gemini 3.5 Flash-Lite 模型页面

如需了解详细价格信息，请参阅价格页面。

快速入门

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.outputText);
}

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 相比，完成多步工作流所需的推理步骤、对话轮次和工具调用次数更少。它还减少了执行循环的螺旋式上升。
• 改进了代码生成 ：生成更高质量、可用于生产用途的代码，减少了不必要的修改和调试循环。
• 更好地遵循指令：减少了诊断任务期间不必要的文件更改。
• 强大的多模态和空间推理能力 ：在图表解读、视觉蓝图转换和多元素网页布局生成方面的性能有所提升。
• 预先进行程序化检查 ：与 Gemini 3.5 Flash 相比，更倾向于在进行更改之前运行诊断代码脚本。这提高了复杂任务的准确性，但可能会在简单的前端工作中增加额外的探索步骤。
• 支持“计算机使用” ：作为智能体界面自动化的原生工具提供支持。
• 界面样式偏好：更擅长创建功能性代码，但人类评估者更喜欢早期模型提供的图文并茂和样式。您可以通过提供明确的设计指南来缓解此问题。
• 默认思考量（中等） ：使用与 Gemini 3.5 Flash 相同的 medium 默认思考等级。
• 降低了价格：降低了输出 token 费用（7.50 美元/百万，而 3.5 Flash 为 9.00 美元/百万）。输入 token 仍为 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 相比，在多轮指令遵循和角色一致性方面表现更强。
• 支持“计算机使用” ：作为智能体界面自动化的原生工具提供支持。

选择合适的 Flash 或 Flash-Lite 模型

使用下表为您的工作负载选择合适的模型和迁移路径。

这两种模型都需要移除已废弃的采样参数（temperature、top_p、top_k）和预填充的模型轮次。如需了解详情，请参阅 API 变更。

更新后的 Antigravity 智能体

由于性能有所提升，Gemini 3.6 Flash 现在是 Gemini 托管式智能体 中 Antigravity 智能体 的新默认模型。您可以通过在 API 上设置新字段来更改此设置。

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-05-2026",
    input="Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    environment="remote",
)

print(interaction.output_text)

import { GoogleGenAI } from "@google/genai";

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    agent: "antigravity-preview-05-2026",
    input: "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    environment: "remote",
}, { timeout: 300000 });

console.log(interaction.output_text);

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-d '{
    "agent": "antigravity-preview-05-2026",
    "input": "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    "environment": "remote"
}'

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

• 更新模型 ID ：将目标模型字符串更改为 gemini-3.6-flash。
• 移除已废弃的采样参数：
  • 从生成配置中移除 temperature、top_p 和 top_k。
  • 将 thinking_budget 替换为字符串枚举 thinking_level，并将其设置为 "medium" 或 "high"。
  • 移除 candidate_count（Gemini 3.x 中不支持）。
• 强制执行轮次验证规则：
  • 在服务器端 previous_interaction_id 上标准化多轮对话。
  • 移除预填充的模型轮次。
• 审核函数调用
  • 将多模态素材资源放在响应载荷内。
  • 使用 \n\n 设置内嵌指令的格式。
  • 如果您看到 Malformed_Function_Call 错误与工具前文本相关，请参阅 工具前文本要求的解决方法。
  • 仅在使用 generateContent API 时：确保所有 FunctionResponse 对象都包含 call_id 和 name。
• Gemini 3.x 基准要求：如需了解 SDK 更新和思考签名保留，请参阅Gemini 3.5 迁移核对清单。

迁移到 gemini-3.5-flash-lite

• 更新模型 ID ：将目标模型字符串更改为 gemini-3.5-flash-lite。
• 配置思考量等级：
  • 对于大量提取、路由或分类：将 thinking_level 保留为 "minimal"（默认值），以实现最大吞吐量。
  • 对于包含工具调用、代码执行或多步推理的自主子智能体：将 thinking_level 设置为 "medium" 或 "high"，以防止工具过早终止。
• 移除已废弃的参数并验证函数调用：应用与 3.6 Flash 相同的规则。
• Gemini 3.x 基准要求：请参阅Gemini 3.5 迁移核对清单。

后续步骤

• 查看模型概览中的 API 规范。
• 探索 Interactions API 指南 中的多智能体编排。
• 在 Google AI Studio 中测试和优化提示。