DeepSeek V4 API 迁移指南：模型名、思考模式与兼容性检查

DeepSeek API 当前推荐使用 deepseek-v4-flash 与 deepseek-v4-pro。如果你的代码还写着 deepseek-chat 或 deepseek-reasoner，不要只依赖兼容映射：应尽快改成现行模型名，并在测试环境完成回归。

一、先改模型名，再检查行为

• deepseek-v4-flash：优先考虑响应速度与成本的通用任务。
• deepseek-v4-pro：更适合复杂推理、代码与高质量生成任务。
• deepseek-v4-flash-vision-exp：实验性视觉模型，不建议未经评估直接用于关键生产链路。

const completion = await client.chat.completions.create({
  model: 'deepseek-v4-pro',
  messages: [{ role: 'user', content: '请检查这段 SQL 的风险。' }],
  stream: false,
});

二、不要忽略思考模式的默认行为

V4 支持思考与非思考模式，官方文档当前说明思考模式默认开启。需要低延迟时可显式关闭；需要复杂推理时，则应明确设置推理强度，避免不同环境使用隐含默认值。

const completion = await client.chat.completions.create({
  model: 'deepseek-v4-pro',
  messages,
  reasoning_effort: 'high',
  thinking: { type: 'enabled' },
});

三、上线前做四类回归

1. 结构回归：检查 JSON、工具调用参数和停止原因是否仍符合解析器预期。
2. 质量回归：用真实业务样本比较正确率、拒答率和格式遵循率。
3. 性能回归：分别记录首字延迟、总耗时、输入与输出 Token。
4. 成本回归：以官方最新价格和真实缓存命中情况重新估算。

模型升级不是字符串替换。把模型名、参数、响应解析和监控指标视为同一次发布，才能降低线上意外。