Google 发布 Gemini 3.7 Flash：面向工程与智能体的新工作模型

Gemini 3.7 Flash (gemini-3.7-flash) 已正式发布（GA），可用于生产环境。它是我们迄今为止在软件工程和 Agent 工作流方面最智能的主力模型。

本指南介绍 Gemini 3.7 Flash 的新特性、API 变更、代码示例和迁移说明。

新模型

模型	模型 ID	默认思考级别	定价	描述
Gemini 3.7 Flash	gemini-3.7-flash	medium	3.7 Flash 年底前以首发优惠价提供，输入 token 为 $0.75/1M，输出 token 为 $3.75/1M；更多详情请参阅下方定价信息。	我们最强大的 Flash 模型，专为复杂编码、Agent 工作流和可靠的多步执行而打造。

Gemini 3.7 Flash 支持 1M token 的上下文窗口、最大 64k 的输出 token、可调节的思考级别（low、medium、high），以及与 3.6 Flash 相同的内置工具套件。

完整规范请参阅 Gemini 3.7 Flash 模型页面。详细定价请参阅定价页面。

快速开始

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.7-flash",
    input="Write a three.js script that renders a realistic 3D black hole."
)

print(interaction.output_text)

Gemini 3.7 Flash 的新特性

编码与 Agent 任务

在实际软件工程和 Agent 基准测试中质量显著提升，改善了问题解决能力，并减少了 Agent 循环失败。

Web 开发与更强的设计一致性

可直接从设计稿生成更高保真度的桌面和 Web 应用代码，在设计遵循度，以及对照设计稿审计现有代码库以验证 1:1 设计一致性方面，均有显著提升。

促销定价

Gemini 3.7 Flash 将以首发优惠价提供，输入 token 为 $0.75/1M，输出 token 为 $3.75/1M。我们也将此新价格应用于 3.6 Flash。首发优惠价将于 2026 年 12 月 31 日到期；之后将适用输入 token $1.50/1M、输出 token $7.50/1M 的价格。

选择合适的模型

请参考下表，查看适合你的工作负载的推荐迁移目标。要从 Gemini 3.5 Flash、Gemini 3 Flash（预览版）或 Gemini 3.1 Pro 升级，请确保移除已弃用的采样参数（temperature、top_p、top_k）和预填充的模型轮次。Gemini 3.6 Flash 已不再支持这些参数。

模型	主要使用场景	推荐的迁移目标
Gemini 3.7 Flash (gemini-3.7-flash)	代码生成、空间/多模态推理、多步 Agent 工作流、设计遵循度	Gemini 3.6 Flash、Gemini 3.5 Flash、Gemini 3 Flash（预览版）或 Gemini 3.1 Pro

理解思考级别

Gemini 3.7 Flash 通过调整模型的思考级别，让开发者能够灵活控制延迟和智能程度：

低思考强度

缩短延迟敏感型任务（如事件响应管道、实时聊天、草稿撰写和快速数据分析）的响应时间。

中等（默认）

大多数任务的最佳质量。推荐用于复杂代码和 Agent 使用场景，具备更高的首次通过准确率。

高思考强度

最大化模型的思考和工具使用能力。最适合复杂推理、高难度数学，以及最具挑战性的编码和 Agent 任务。支持更长时间的思考和函数调用，但 token 消耗和成本更高。

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.7-flash",
    input="Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely.",
    generation_config={
        "thinking_level": "medium"  # 在控制 token 预算的同时处理复杂任务
    }
)

print(interaction.output_text)

更新后的 Antigravity Agent

凭借更强大的性能和推理能力，Gemini 3.7 Flash 现已成为 Gemini Managed Agents 和 Google Antigravity SDK 中 Antigravity Agent 的新默认模型。

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-05-2026",
    input=(
        "Audit https://web.dev for performance, Core Web Vitals, and SEO. "
        "Query Google's PageSpeed Insights API for both Mobile and Desktop strategies. "
        "Check search indexing with Google Search for site:web.dev. "
        "Format the output as a side-by-side scorecard table with prioritized fixes."
    ),
    environment="remote",
    # agent_config={"type": "antigravity", "model": "gemini-3.6-flash"} # 配置模型
)

print(interaction.output_text)

底层 Gemini 模型可以使用 agent_config 进行配置。

迁移清单

注意：使用编码 Agent 自动完成此迁移。如果你使用的是支持 skills 的编码 Agent（如 Antigravity），请安装 Gemini Interactions API skill 并运行：

/gemini-interactions-api migrate my app to Gemini 3.7 Flash

迁移到 gemini-3.7-flash

更新模型 ID

将目标模型字符串更改为 gemini-3.7-flash。

移除已弃用的采样参数

• 从 generation config 中移除 temperature、top_p 和 top_k。
• 将 thinking_budget 替换为字符串枚举 thinking_level。
• 移除 candidate_count（Gemini 3.x 不支持）。

强制实施轮次验证规则

• 使用服务端 previous_interaction_id 来标准化多轮对话。
• 移除预填充的模型轮次。

审计函数调用

• 将多模态资源放入响应负载中。
• 使用 \n\n 格式化内联指令。

如果你看到与工具前文本相关的 Malformed_Function_Call 错误，请参阅工具前文本要求的解决方法。

仅当使用 GenerateContent API 时： 确保所有 FunctionResponse 对象都包含 call_id 和 name。

Gemini 3.x 基线要求： 有关 SDK 更新和 thought signature 保留，请参阅 Gemini 3.5 迁移清单。

定价

促销定价适用于 Google AI Studio 和 GE Agent Platform，Gemini 3.7 Flash 和 Gemini 3.6 Flash 的促销有效期均至 2026 年 12 月 31 日。自 2027 年 1 月 1 日起，将采用标准定价。详情请参阅定价页面。

后续步骤

• 在 Models Overview 中查看 API 规范。
• 在 Interactions API 指南 中探索多 Agent 编排。
• 在 Google AI Studio 中测试和优化提示词。

• 原文链接： x.com/GoogleAIStudio/sta...
• 鸿途知科网 AI 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～