一、迁移背景

DeepSeek官方宣布，旧版模型（deepseek-chat、deepseek-reasoner）将于2026年7月24日正式退役。届时所有调用旧版API的应用将无法正常工作，开发者必须迁移到新模型（deepseek-chat-v3、deepseek-reasoner-v3）。

时间节点

• 退役日期：2026年7月24日
• 迁移工具上线：2026年7月1日
• 迁移截止：建议在2026年7月20日前完成

影响范围

所有使用以下旧版模型的应用：

• deepseek-chat
• deepseek-chat-lite
• deepseek-reasoner
• deepseek-reasoner-lite

二、迁移工具功能详解

1. 代码检测工具

迁移工具提供代码检测功能，可以自动扫描项目中的旧版模型调用：

检测范围：

• API调用中的模型名称
• SDK配置文件
• 环境变量
• 配置文件中的模型参数

使用方法：

``bash npx @deepseek/migration-tool analyze --project ./ ``

输出示例： ``` 检测结果：

• src/api/client.js: 第15行发现旧模型 'deepseek-chat'
• config/env.js: 第8行发现环境变量 'DEEPSEEK_MODEL'
• package.json: 依赖版本需更新

```

2. 一键迁移功能

检测完成后，工具可以自动完成迁移：

``bash npx @deepseek/migration-tool migrate --project ./ --model deepseek-chat-v3 ``

自动完成的操作：

• 替换API调用中的模型名称
• 更新SDK配置文件
• 调整API参数（新模型部分参数名称有变化）
• 更新依赖版本

3. 批量替换模式

对于大型项目，可以使用批量替换模式：

``bash npx @deepseek/migration-tool replace \ --search "deepseek-chat" \ --replace "deepseek-chat-v3" \ --path ./src ``

三、API参数变化

新模型的API参数有一些变化，需要特别注意：

主要变化

新增参数

• response_format：支持JSON模式输出
• tools：工具调用支持
• system_prompt：系统提示词参数

四、迁移步骤

Step 1：安装迁移工具

``bash npm install -g @deepseek/migration-tool ``

Step 2：检测项目

``bash deepseek-migrate analyze --project ./your-project ``

Step 3：执行迁移

``bash deepseek-migrate migrate --project ./your-project ``

Step 4：测试验证

``bash deepseek-migrate test --project ./your-project ``

Step 5：部署上线

完成所有测试后，部署更新后的代码到生产环境。

五、常见问题

Q1：迁移会影响现有功能吗？

A：新模型与旧模型接口兼容，迁移后功能不受影响。但建议在测试环境充分测试后再部署到生产环境。

Q2：如何处理自定义的API参数？

A：迁移工具会保留自定义参数，但新模型可能不支持某些旧参数。建议查看官方文档确认参数兼容性。

Q3：迁移后性能有变化吗？

A：新模型在响应速度和生成质量上都有提升，API调用费用保持不变。

Q4：迁移工具支持哪些语言？

A：目前支持JavaScript/TypeScript、Python、Go等主流编程语言。

六、迁移进度追踪

官方提供了迁移进度追踪功能：

``bash deepseek-migrate status --api-key YOUR_API_KEY ``

输出信息：

• 当前使用的模型版本
• 迁移状态
• 剩余迁移时间
• 使用建议

*距离旧版模型退役仅剩6天，请尽快完成迁移！官方技术支持热线：support@deepseek.com*