DeepSeek 官方发布公告，deepseek-chat 和 deepseek-reasoner 两个旧模型别名将于北京时间 2026 年 7 月 24 日 23:59 正式弃用。如果你的代码、环境变量或网关配置中还在使用这两个名称，截止时间一到，API 调用就会失败。
DeepSeek 要求所有 API 调用改用 deepseek-v4-flash 或 deepseek-v4-pro。官方 API 的 base_url 保持不变，需要调整的是 model 参数，以及原来被旧模型名隐式绑定的思考模式（thinking）配置。
迁移清单：四步完成
第一步：全局搜索旧模型名
在代码仓库、.env 文件、部署变量、工作流配置和网关后台中，全面搜索以下两个关键词：
deepseek-chat
deepseek-reasoner注意：不要只查业务代码。很多项目中真正生效的模型名称藏在环境变量或平台配置面板里。搜索完成后，确认线上运行时实际读取的是哪一处配置。
第二步：替换为明确的 V4 模型名称
如果想尽量延续旧别名的兼容行为，可以先统一替换为 deepseek-v4-flash。
根据官方说明，旧的 deepseek-chat 此前对应 V4-Flash 的非思考模式，而 deepseek-reasoner 对应 V4-Flash 的思考模式。不要简单地把两个旧名称都替换成同一个字符串，然后默认行为会自动一致。
第三步：检查思考模式（thinking）配置
V4 将"选模型"和"是否开启思考"拆成了两个独立配置。以前使用 deepseek-reasoner 默认就是推理链路，现在需要在调用中显式配置 thinking 参数。
如果原来调用的是普通聊天（非推理），也需要注意：V4 的思考模式默认开启，想保持旧 deepseek-chat 的非思考行为，需要明确关闭。使用 OpenAI SDK 时，官方要求将 thinking 参数放入 extra_body 中传递。
踩坑记录：在思考模式下，temperature、top_p、presence_penalty、frequency_penalty 这些参数即使还留在配置中也不会生效。建议顺手检查一遍，避免它们继续留在配置里制造误导。
第四步：用真实请求验证
修改完成后，至少用一条线上会跑的真实任务做完整验证：模型能正常返回、结果符合预期、日志中没有旧模型名残留。
关键提醒：如果你的 Agent 或工作流会调用工具，必须把整条链路跑到最终回答。官方特别指出：思考模式下发生工具调用后，后续请求必须完整回传 reasoning_content，否则 API 会返回 400 错误。只测试"第一步能调工具"不算迁移完成。
迁移速查表
- 只用普通对话：把旧模型名替换为 V4 模型，确认是否需要关闭思考模式。
- 原来使用 reasoner：明确选择 V4 模型，开启思考模式，再验证一条真实推理任务。
- 用了工具调用或 Agent：除了模型和思考模式，还要验证
reasoning_content的续传链路。 - 用了第三方网关/聚合平台：同时检查对方的模型列表和迁移说明。DeepSeek 官方文档不能自动保证第三方平台已完成适配。
模型名迁移看起来不复杂，但最怕拖延。这种配置平时没人碰，一旦过了截止时间，它就会在最不该掉链子的地方出问题。如果你在用 DeepSeek API，建议今天就完成搜索、替换和验证。
