Gemini 3.7 Flash 正式弃用：迁移至 3.8 Flash 及 Deep Research 代理更新指南
Google 于 2026 年 10 月 8 日发布的更新日志中正式宣布：Gemini 3.7 Flash 已停止服务。自 2026 年 10 月 15 日起，任何指向旧模型 ID (gemini-3.7-flash) 的 API 请求将被自动重定向至新一代模型 Gemini 3.8 Flash。
虽然重定向机制保证了请求仍能返回响应，但这并不意味着迁移已完成。许多开发者误以为“请求成功”即代表配置更新成功，实则忽略了底层模型 ID 的变更。为确保应用逻辑、参数兼容性及功能行为的一致性，开发者必须采取主动措施进行显式迁移。
核心迁移任务
本次更新涉及两个主要维度的变更：
1. 模型 ID 与重定向机制
- 自动重定向：Google 已接管路由逻辑，旧 ID 请求自动转发至
gemini-3.8-flash。 - 配置风险：若应用配置仍保留旧 ID，虽能运行，但无法保证行为完全一致（例如输出格式、推理深度等）。
- 最佳实践：立即在代码配置中显式将
model字段更新为gemini-3.8-flash，并移除对旧 ID 的依赖。
2. Deep Research 代理更新
与模型 ID 的重定向不同，Deep Research 功能的迁移需要开发者主动修改 agent 参数，否则服务将在 2026 年 10 月 23 日关闭。
- 旧版代理：
deep-research-pro-preview-12-2025 - 新版代理：
deep-research-preview-04-2026deep-research-max-preview-04-2026
开发者需在发送 Interactions 请求时，明确指定新的 Agent ID，切勿沿用旧版配置。
关键参数变更与兼容性检查
Gemini 3.8 Flash 引入了显著的 API 参数变更，开发者需特别注意以下废弃项与替换项：
| 废弃参数 (旧版) | 新参数 (3.8 Flash) | 说明 |
|---|---|---|
thinking_budget |
thinking_level |
推理预算控制，支持 low, medium, high。minimal 已不支持。 |
temperature |
- | 已废弃，不再支持。 |
top_p, top_k |
- | 采样参数已废弃。 |
candidate_count |
- | 候选数量控制已废弃。 |
| 预填充模型轮次 | - | 相关参数已移除。 |
迁移检查清单：
- 替换参数：将
thinking_budget替换为thinking_level，默认值设为medium。 - 清理废弃字段：从
generation_config中彻底移除temperature,top_p,top_k,candidate_count等字段。 - 验证 SDK 映射：内部配置文件中的字段名可能与客户端库发送的实际参数不一致，务必在部署前进行端到端测试。
自动化迁移验证脚本
为了辅助排查配置问题，以下 Python 函数可用于本地验证请求对象是否符合 3.8 Flash 规范：
def migration_issues(config):
issues = []
# 检查旧模型 ID
if config.get("model") == "gemini-3.7-flash":
issues.append("deprecated_model")
generation = config.get("generation_config", {})
# 检查废弃参数
deprecated_fields = ("thinking_budget", "temperature", "top_p", "top_k", "candidate_count")
for field in deprecated_fields:
if field in generation:
issues.append(field)
# 检查不支持的推理级别
if generation.get("thinking_level") == "minimal":
issues.append("unsupported_minimal")
return issues
# 示例：旧配置将产生 4 个错误
old_config = {
"model": "gemini-3.7-flash",
"generation_config": {
"thinking_budget": 1024,
"temperature": 0,
"candidate_count": 1,
},
}
# 示例：新配置应无错误
new_config = {
"model": "gemini-3.8-flash",
"generation_config": {"thinking_level": "medium"},
}
assert len(migration_issues(old_config)) == 4
assert migration_issues(new_config) == []
总结与建议
- 不要依赖静默重定向：仅凭请求成功不能证明迁移完成，必须检查响应中的实际模型信息。
- 分离检查清单：将模型迁移与 Deep Research 代理迁移视为两个独立任务，分别设定截止日期和验收标准。
- 审查运行时配置：检查
.env文件、部署模板及后台任务队列，确保所有环境均加载了最新的配置映射。
Google 强调，显式的配置更新是确保应用行为符合新模型预期合同的关键。请即刻启动迁移计划，避免服务中断。
"Make the transition explicit in configuration and logs. Do not silently label old configuration as a completed migration merely because a response contains plausible text."
官方团队/CEO 发言：Google AI 团队
SEO 优化信息
- SEO 标题：Gemini 3.7 Flash 弃用迁移指南：更新至 3.8 Flash 及 Deep Research 代理
- SEO 描述：Google 宣布 Gemini 3.7 Flash 正式弃用，请求自动重定向至 3.8 Flash。详解参数变更、Deep Research 代理迁移及自动化检查脚本，助开发者平滑过渡。
- SEO 关键词：Gemini 3.8 Flash, 模型迁移, API 更新, Deep Research, AI 工具
