Gemini 3.7 Flash (gemini-3.7-flash) 已正式发布 (GA),可用于生产环境。这是 Google 迄今为止最智能的主力模型,专为编码和智能体任务打造。
本指南介绍了 Gemini 3.7 Flash 中的新增功能、API 变更、代码示例和迁移指南。
新建模型
| 模型 | 模型 ID | 默认思考等级 | 价格 | 说明 |
|---|---|---|---|---|
| Gemini 3.7 Flash | gemini-3.7-flash |
medium |
3.7 Flash 将以初次体验价提供至今年年底,即每百万输入 token 为 0.75 美元,每百万输出 token 为 3.75 美元;如需了解详情,请参阅价格。 | Google 最强大的 Flash 模型,专为复杂编码、智能体工作流和可靠的多步执行而打造。 |
Gemini 3.7 Flash 支持 100 万个 token 的上下文窗口、最多 6.4 万个输出 token、可调的思考水平(low、medium、high),以及与 3.6 Flash 相同的内置工具套件。
如需查看完整规格,请参阅 Gemini 3.7 Flash 模型页面。如需了解详细价格信息,请参阅价格页面。
快速入门
Python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-3.7-flash",
input="Write a responsive navigation component in React with smooth animations and dark mode toggle."
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const client = new GoogleGenAI({});
const interaction = await client.interactions.create({
model: "gemini-3.7-flash",
input: "Write a responsive navigation component in React with smooth animations and dark mode toggle.",
});
console.log(interaction.output_text);
Java
import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
Client client = new Client();
CreateModelInteraction req = CreateModelInteraction.builder()
.model(Model.of("gemini-3.7-flash"))
.input(InteractionsInput.of("Write a responsive navigation component in React with smooth animations and dark mode toggle."))
.build();
Interaction interaction =
client.interactions.create(CreateInteractionRequestBody.of(req)).interaction().get();
System.out.println(interaction.outputText().orElse(""));
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.7-flash",
"input": "Write a responsive navigation component in React with smooth animations and dark mode toggle."
}'
Gemini 3.7 Flash 的新功能
- 编码和智能体任务:在实际软件工程和智能体基准方面,质量显著提高,有助于改进问题解决能力并减少智能体循环失败的情况。
- Web 开发和更强的设计对等性:直接从设计模拟生成高保真桌面和 Web 应用代码,在设计一致性方面取得了显著进步,并且能够根据模拟审核现有代码库,以验证设计对等性是否达到 1:1。
- 促销价格:Gemini 3.7 Flash 将以初次体验价提供,即每百万输入 token 为 0.75 美元,每百万输出 token 为 3.75 美元。我们还将此新费率应用于 3.6 Flash。初次体验价将于 2026 年 12 月 31 日到期;之后,费用将为每 100 万个输入 token 1.50 美元,每 100 万个输出 token 7.50 美元。
选择合适的模型
请参阅下表,了解建议的工作负载迁移目标。如需从 Gemini 3.5 Flash、Gemini 3 Flash(预览版)或 Gemini 3.1 Pro 升级,请务必移除已弃用的抽样参数(temperature、top_p、top_k)和预填充的模型对话轮次。Gemini 3.6 Flash 已不再支持这些参数。
| 模型 | 主要使用场景 | 建议的迁移目标 |
|---|---|---|
Gemini 3.7 Flashgemini-3.7-flash |
代码生成、空间/多模态推理、多步骤智能体工作流、设计遵循 | Gemini 3.6 Flash、Gemini 3.5 Flash、Gemini 3 Flash(预览版)或 Gemini 3.1 Pro |
了解推理水平
Gemini 3.7 Flash 可让开发者通过调整模型的思考等级来灵活控制延迟和智能程度:
- 低思考力度:缩短了延迟时间敏感型任务(例如突发事件响应流水线、实时聊天、撰写草稿和快速数据分析)的回答时间。
- 中等(默认):最适合大多数任务的质量。建议用于复杂的代码和智能体应用场景,具有更高的首次通过准确率。
- 思考力度:最大限度地发挥模型思考和使用工具的能力。最擅长处理复杂的推理、高难度的数学问题、棘手的编码和智能体任务。允许进行更深入的思考和函数调用,但会消耗更多 token 并产生更高费用。
如需在 Gemini 3.7 Flash 中配置思考级别,请执行以下操作:
Python
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" # Balanced reasoning effort for complex tasks
}
)
print(interaction.output_text)
如需查看多语言代码示例(JavaScript、Java、Go、REST)和深入的推理概念,请参阅 了解 Gemini 3.8 Flash 中的推理级别。
Antigravity 智能体支持
Gemini 3.7 Flash 引入了对 Gemini 托管式智能体中的 Antigravity 智能体和 Google Antigravity SDK 的支持。
如需查看当前代码示例和最新的默认代理配置,请参阅 Antigravity 代理指南和 Gemini 3.8 Flash 指南。
迁移核对清单
`/gemini-api-dev migrate my app to Gemini 3.7 Flash`
迁移到 gemini-3.7-flash
- 更新模型 ID:将目标模型字符串更改为
gemini-3.7-flash。 - 配置思考水平:将
thinking_budget替换为字符串枚举thinking_level,并根据工作负载的需要将其设置为"low"、"medium"(默认)或"high"。 - 应用 Gemini 3 API 参数更改:移除已弃用的抽样参数(
temperature、top_p、top_k)、candidate_count(在 Gemini 3 及更高版本中不受支持)和预填充的模型对话轮次。请参阅 Gemini 3.6 API 变更和参数更新。 - Gemini 3.x 基准要求:如需了解函数调用严格响应匹配、SDK 更新和思考签名保留,请参阅 Gemini 3.5 迁移核对清单。
价格
如需了解完整的价格详情和促销费率,请参阅价格页面。
后续步骤
- 查看模型概览中的 API 规范。
- 如需探索多代理编排,请参阅 Interactions API 指南。
- 在 Google AI Studio 中测试和优化提示。