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

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

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

• deepseek-flash：当前推荐的快速通用模型，并支持官方文档所述的视觉输入能力。
• deepseek-v4-pro：当前 V4 Pro API 名称；继续提供 Pro 服务，使用 Pro 独立单价。
• 旧 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. 成本回归：以官方最新价格和真实缓存命中情况重新估算。

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