1 兼容性公告之后的三道坑
DeepSeek-V4-Pro(API 标识 deepseek-v4-pro,GA 版本常记为 V4-Pro-0813)已在 App、Web 与官方 API 上线。对工具链团队真正重要的,不只是某一项基准分,而是原生支持 OpenAI Responses 格式,并能对接 Codex 一类循环。调用地址仍是 https://api.deepseek.com。「全面兼容 OpenAI」经常被当成营销合同,三处缺口会让过快迁移直接翻车。
① SDK 能换,契约不能默认相等。把 OpenAI 客户端的 base_url 指到 DeepSeek,responses.create 往往能通。但 store、background、prompt 以及多种缓存选项并不齐全。OpenAI 侧带状态的会话,在这里仍是无状态请求。
② 三种方言,同一套模型。Completions、Anthropic Messages 与 Responses 暴露同一权重。一个混用工具、reasoning.effort 和结构化输出的 Agent,可能在一种格式下通过、另一种格式下失败。
③ Agent 不等于推理服务。Codex、Claude Code 或 MCP 编排器仍要执行 Git、测试与构建。API 延迟解释不了本机因 Xcode、iOS 模拟器或视频编码而换页。评测性能时,要把「模型推理」和「Apple 工具链执行」拆开记账。
2 对照矩阵:三种格式,一次决策
| 格式 | 典型用途 | 先测什么 | 速判 |
|---|---|---|---|
| Chat Completions | 现有 OpenAI 客户端 | 工具、流式、温度 | 迁移成本最低 |
| Anthropic Messages | Claude Code 与 Claude 套件 | /anthropic 端点、tool_choice | 已有 Claude 栈更合适 |
| Responses API | Codex Agent、input + instructions | 部分工具、reasoning、store=false | 新路径,不是 OpenAI 克隆 |
已支持的核心字段
根据 官方 Responses 指南,input、instructions、stream、temperature、max_output_tokens 与 tool_choice 可用。工具为部分支持(function 与 web_search;其他类型会被忽略)。
刻意保留的差异
reasoning.effort 会生效;summary 可接受但不生成摘要。store 被强制为 false。超出窗口返回 HTTP 400,而不是静默截断。适配性评测要把这些行为写进用例,而不是只看首包延迟。
3 场景速配:谁现在该切 Responses
| 团队 | 建议 | 原因 |
|---|---|---|
| Codex / 文件 Agent 原型 | Responses + 工具日志 | input 贴合 Agent 循环 |
| CI 已跑 Completions | 保留 Completions,并行测 Responses | 避免流水线回归 |
| Claude Code 已在生产 | 先走 Anthropic Messages | SDK 摩擦更小 |
| 机密 macOS / iOS 仓库 | API + 隔离 Mac(SSH/VNC) | 模型走远端,代码留在独占硬件 |
4 五步落地:评测 V4 Pro,不拆生产
-
1
冻结契约。记下模型
deepseek-v4-pro、base_url、格式(Completions 还是 Responses)以及实际使用的字段清单。 - 2 重跑三类任务。带测试的缺陷修复、跨文件修改、一次长工具任务。同一提示词、同一超时。
-
3
记录被忽略的字段。某类工具消失或
verbosity无效果,写进文档:这是契约差异,不是 SDK 故障。 - 4 把执行器与推理拆开。DeepSeek API 留在供应商侧。构建、模拟器与 Git 跑在独立机器上。在 vmzig 租用独占 Mac mini M4,避免密钥与 Agent 混在个人笔记本。
- 5 定角色再放流量。路由候选、Completions 替代,还是仅 Codex 实验。工具失败率可接受后再开生产流量。
最小示例(OpenAI SDK,按需改):用 DeepSeek Key 建客户端,再调用 client.responses.create(model="deepseek-v4-pro", instructions=..., input=...),读取 output_text。非流式稳定后再开流式。宣传里的超大上下文,只有在真实仓库上量过成本、延迟和工具调用次数后才可信。冻结模型 ID 前,先读 DeepSeek 更新日志。
5 可写入内部评审的四点
- ✓V4-Pro 约在 2026 年 8 月 12–13 日 GA;调用方式不变,模型名
deepseek-v4-pro指向当前版本。 - ✓Responses 为原生且面向 Codex;这不是与 OpenAI 字段一一对等。
- ✓Flash 更早支持 Responses;Pro 把它带进 GA。不要默认相同并发上限或开放权重。
- ✓Pro 的 GA 权重不是本地替代方案:评测走 API,工具执行放在你自己的基础设施。
6 常见问题
能否用 DeepSeek V4 Pro 直接替换 OpenAI Responses 端点?
核心路径(input、instructions、stream、function 工具)多数可以。store、background、截断策略和若干缓存选项不行。先核对你的字段清单。
还要不要继续用 Chat Completions?
要。Completions 仍是旧集成最稳的路径。Agent 已经按 input / instructions 组织时,Responses 才值得主推。工具轨迹可对比之前,生产只保留一种格式。
评测一定要云端 Mac 吗?
模型走 API。远程 Mac 负责 Git、构建和模拟器,不把主力电脑暴露给 Agent。对接 Apple 仓库时,这是正确的职责拆分。
V4 Flash 和 V4 Pro 能互相替换吗?
不能。限额与定位不同。用同一套工具任务对比后再锁定 Agent 默认模型。API 单价覆盖不了 Mac、日志和工具失败成本。
7 总结:评测完再下单
结论:DeepSeek V4 Pro 进入 GA 后,Responses 不再需要适配器拼凑,Codex 原型会更快。兼容性仍是选择性的:切生产前先量工具、推理档位和 400 错误。若链路已在 Completions 或 Anthropic 上验证,先保留,不要为了公告一次性替换。
跑 Xcode、UI 测试或多 Agent 并行,并不需要「给模型买一台 Mac」——模型在 API 上。你要租的是独占 Apple Silicon 节点:隔离仓库,把 V4 Pro 和现网模型对照。Responses 评测架搭好后,去 vmzig 定价页看套餐,并在 购买页立刻下单 Mac mini M4,把 Git、模拟器和密钥从个人电脑上拆出来。
vmzig M4 远程节点
在独占 Mac 上评测 DeepSeek V4 Pro
Responses 走 DeepSeek API,Codex、Git 与 Apple Silicon 测试在物理独占机器上隔离。SSH 直连,即租即用。