DeepSeek旧模型名7月24日停用：迁移前检查这6处

DeepSeek官方明确，API中的deepseek-chat和deepseek-reasoner将在北京时间2026年7月24日23:59弃用。迁移不能只做一次字符串替换，还要核对思考模式、网关映射、工具调用消息、环境配置和发布回滚。本文给出Python、Node.js示例及一份上线检查清单。

如果你的项目接入DeepSeek API比较早，配置里很可能还写着下面两个模型名：

deepseek-chat
deepseek-reasoner

它们马上就不能继续用了。

DeepSeek官方文档已经明确：这两个旧模型名将在北京时间2026年7月24日23:59弃用。当前过渡期内，deepseek-chat和deepseek-reasoner分别指向deepseek-v4-flash的非思考模式与思考模式；截止时间之后，依赖旧模型名的请求就不应再被当成可用链路。

这项变化针对的是API调用、兼容接口和使用DeepSeek作为后端的工具。只在DeepSeek网页或App里聊天的普通用户，不需要修改代码。

真正需要警惕的是：这次迁移不等于把旧字符串全部替换成deepseek-v4-flash就结束了。新模型默认启用思考模式；如果原来调用的是deepseek-chat，只改模型名却没有明确关闭思考模式，输出延迟、参数行为和程序处理逻辑都可能发生变化。

先把新旧关系说清楚

V4-Flash更适合延迟和成本敏感的常规调用；V4-Pro更适合复杂推理和Agent任务。两者都支持思考与非思考模式，所以模型档位和是否思考现在是两个需要分别决定的配置项。

下面这6处，建议在上线前逐项检查。

1. 搜索的不只是源代码

先在项目根目录全局搜索旧模型名：

rg -n "deepseek-(chat|reasoner)" .

如果没有安装rg，也可以使用IDE的全局搜索。不要只查.py或.js，至少还要覆盖：

• .env、.env.production和配置中心；
• YAML、JSON、TOML及docker-compose.yml；
• GitHub Actions、Jenkins等CI/CD变量；
• 模型网关、代理服务和低代码平台里的模型映射；
• 数据库中保存的租户配置、机器人配置和默认模型；
• 单元测试、Mock数据、监控规则与告警文本。

最容易漏掉的通常不是业务代码，而是线上环境变量和管理后台中的默认值。

2. 把模型和思考模式拆成两个配置

不要继续把模型名散落在各个业务函数里。至少抽成下面三项：

DEEPSEEK_BASE_URL=https://api.deepseek.com
DEEPSEEK_MODEL=deepseek-v4-flash
DEEPSEEK_THINKING=disabled

这样做的价值不是“配置看起来整齐”，而是出现延迟、成本或兼容问题时，可以单独切换模型档位或思考模式，不需要重新修改所有调用点。

Python：非思考模式

import os
from openai import OpenAI

client = OpenAI(
api_key=os.environ["DEEPSEEK_API_KEY"],
base_url=os.getenv(
"DEEPSEEK_BASE_URL",
"https://api.deepseek.com",
),
)

response = client.chat.completions.create(
model=os.getenv("DEEPSEEK_MODEL", "deepseek-v4-flash"),
messages=[
{"role": "user", "content": "把这段日志归纳为3条排查建议"}
],
stream=False,
extra_body={"thinking": {"type": "disabled"}},
)

print(response.choices[0].message.content)

Python：复杂任务启用思考模式

response = client.chat.completions.create(
model="deepseek-v4-pro",
messages=[
{"role": "user", "content": "分析这次线上故障的完整因果链"}
],
stream=False,
reasoning_effort="high",
extra_body={"thinking": {"type": "enabled"}},
)

使用OpenAI Python SDK时，DeepSeek官方示例将thinking放在extra_body中。不要把API Key写进代码仓库，示例中应始终从环境变量读取。

Node.js：显式关闭思考模式

import OpenAI from "openai";

const client = new OpenAI({
apiKey: process.env.DEEPSEEK_API_KEY,
baseURL: process.env.DEEPSEEK_BASE_URL
?? "https://api.deepseek.com",
});

const response = await client.chat.completions.create({
model: process.env.DEEPSEEK_MODEL
?? "deepseek-v4-flash",
messages: [
{ role: "user", content: "把这段错误信息转成排查步骤" },
],
thinking: { type: "disabled" },
stream: false,
});

console.log(response.choices[0].message.content);

3. 检查网关和第三方工具里的模型映射

很多项目没有直接请求DeepSeek，而是经过统一模型网关、API代理、Agent框架或编程助手。此时业务代码中可能完全搜不到旧模型名，真正的映射藏在网关里。

需要确认三个问题：

DeepSeek当前公布的地址是：

OpenAI格式：https://api.deepseek.com
Anthropic格式：https://api.deepseek.com/anthropic

Base URL本次不需要改，但模型名、思考参数和消息字段需要重新验证。不要因为“HTTP 200”就认定迁移完成，网关有可能吞掉参数后仍返回一个看似正常的答案。

4. 重新验证思考模式下的参数

DeepSeek V4的思考模式默认开启。官方文档还说明，在思考模式下，下面这些参数不会生效：

temperature
top_p
presence_penalty
frequency_penalty

为了兼容已有软件，即使传入这些参数也可能不报错。这意味着旧项目中的“温度设为0保证输出稳定”，迁移后可能只是看起来还在工作，实际上参数已经被忽略。

另外，reasoning_effort当前支持high和max。兼容值low、medium会映射为high，xhigh会映射为max。如果业务对延迟和成本敏感，不要只看配置文件里的字面值，要在压测中记录实际耗时与Token用量。

5. 工具调用要保留reasoning_content

普通对话迁移成功，不代表Agent链路也成功。

在思考模式下进行工具调用时，模型返回的Assistant消息可能同时包含：

content
reasoning_content
tool_calls

DeepSeek官方要求：如果这一轮发生了工具调用，后续请求必须完整回传reasoning_content。如果中间层为了“精简消息”只保留content和tool_calls，后续调用可能返回400错误。

最稳妥的做法，是直接保留SDK返回的完整Assistant消息：

assistant_message = response.choices[0].message
messages.append(assistant_message)

重点检查自己封装的DTO、消息序列化、数据库字段和跨服务传输协议，确认它们没有丢掉reasoning_content。这往往比改模型名更容易出问题。

6. 灰度发布，并准备真正可用的回滚方案

不要把“切回deepseek-chat”写成回滚方案，因为7月24日之后这个回滚入口本身就会失效。

更可靠的发布流程是：

建议至少覆盖以下回归场景：

• 普通非流式对话；
• 流式输出；
• JSON结构化输出；
• 一次和多次工具调用；
• 超长输入与超时处理；
• 限流、余额不足及上游异常；
• 中文、代码和真实业务Prompt；
• 线上正在使用的关键Agent任务。

一个容易忽略的迁移误区

这次最危险的操作不是“忘记修改”，而是批量替换后直接发布。

例如把：

deepseek-chat

直接替换为：

deepseek-v4-flash

代码可能正常返回结果，但因为新模型默认开启思考模式，业务的延迟、输出结构和参数行为已经改变。表面上没有报错，反而更容易让问题推迟到流量高峰才暴露。

所以正确顺序应该是：

先确认旧调用的真实意图
→ 再选择Flash或Pro
→ 显式决定是否启用思考模式
→ 回归工具调用和结构化输出
→ 最后灰度发布

发布前最后核对

• 项目、配置中心和CI中已不存在旧模型名；
• 模型名与思考模式已经分开配置；
• 网关没有过滤新增参数和消息字段；
• 非思考调用已显式设置thinking=disabled；
• 思考模式下没有依赖已失效的采样参数；
• 工具调用完整保留reasoning_content；
• 流式、JSON、Tool Calls均已回归；
• 监控指标能够按新模型名拆分；
• 回滚方案不再依赖旧模型名；
• 已在北京时间2026年7月24日23:59前完成生产迁移。

结语

模型API升级最怕“接口看起来兼容”，于是团队只改了一个字符串。

DeepSeek这次保持了Base URL不变，也继续兼容OpenAI和Anthropic接口格式，但模型选择、思考模式、参数行为和Agent消息链路都值得重新测试。趁旧模型名仍处于过渡期完成灰度，比在停用后临时排查线上报错稳妥得多。

本文依据2026年7月20日可见的DeepSeek官方资料整理，未将未验证的第三方教程作为功能依据。实际模型、价格和并发限制可能继续调整，上线前应再次核对官方文档。

参考资料