HiDeepSeekDev
空闲特惠
API 选型DeepSeekAPI 格式ResponsesMessages客户端迁移

DeepSeek 三类 API 格式怎么选:Chat Completions、Responses 与 Messages

对照 DeepSeek 提供的三类 API 格式,解释客户端协议、上下文状态、工具消息和模型名映射的差异。优先按现有客户端和所需能力选择,不把格式兼容等同于服务能力完全一致。

快速结论

先选择客户端支持的协议,再查 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 教程。

参考资料

本文依据以下资料整理,版本与接口信息请以来源页面的现行说明为准。

  1. 01DeepSeek 官方模型与 API 能力表api-docs.deepseek.com
  2. 02DeepSeek 官方 Responses 格式指南api-docs.deepseek.com
  3. 03DeepSeek 官方 Anthropic 格式与模型映射api-docs.deepseek.com
  4. 04DeepSeek 官方 Tool Calls 指南api-docs.deepseek.com
阅读至此返回学习中心