快速结论
先选择客户端支持的协议,再查 DeepSeek 当前能力表。Responses 的事件和状态、Messages 的字段与模型名映射均有区别;只改 base URL 可能无法完成所有迁移。
- DeepSeek 价格与模型页列出 Chat Completions、Responses 和 Anthropic 格式支持。
- Responses 使用语义事件流,previous_response_id 等服务端状态功能不受支持。
- Anthropic 格式的官方 base URL 为 https://api.deepseek.com/anthropic。
- 官方说明 claude-opus 前缀映射到 V4 Pro,claude-haiku/sonnet 前缀映射到 Flash;该映射仍调用 DeepSeek。
本次更新:10 月 13 日核验后新增,标明公告日期、适用范围与文档指导性质。
本文按 10 月 13 日的 DeepSeek 官方文档整理三类 API 格式。它们提供不同的客户端接入路径,但字段和支持能力仍需逐项核对,本文没有执行付费调用。
按客户端选择起点
| 格式 | 常见输入组织 | 优先核对 |
|---|---|---|
| Chat Completions | messages 与助手/工具消息 | 消息顺序、工具参数和结果关联 |
| Responses | input、instructions 与输出项 | 语义事件、输入项及无状态历史 |
| Anthropic Messages 格式 | system、messages 与内容块 | SDK 基础地址、字段和模型映射 |
官方模型页分别列出支持项。若现有客户端已经使用某种格式,先做最小请求,再确认工具、图像和思考模式,避免同时改协议与任务逻辑。
Responses 要特别看状态与流式
当前文档说明 Responses 为无状态接口,不支持 previous_response_id 和 conversation 等服务端历史功能。客户端应组织下一轮需要的历史。结束事件也要按 completed、incomplete、failed 区分,不能沿用另一协议的结束标记。
Messages 的模型名不证明模型身份
Anthropic 格式文档给出的 base URL 是 https://api.deepseek.com/anthropic。SDK 与原始 HTTP 路径的拼接规则应分别核对。
官方还描述 Claude 名称前缀映射:opus 对应 DeepSeek V4 Pro,haiku/sonnet 对应 Flash。因此,客户端显示的别名不能单独证明正在调用哪家模型。预算与结果记录应保存服务商、实际路由和模型版本。
用一个业务任务核对完整链路
选择固定的只读任务,分别检查输入、流式完成、工具执行、错误返回与 usage。遇到不支持字段时,查看服务的兼容表;请求未报错不一定代表字段生效。
迁移完成的证据应是相同任务产出符合预期,而不是接口返回一次 200。工具闭环细节见Tool Calls 教程。
参考资料
本文依据以下资料整理,版本与接口信息请以来源页面的现行说明为准。