OpenAI API迁移到Responses要改哪5处字段？

做OpenAI API迁移的决策，只看五个条件：请求入口、消息与状态、工具调用、流式事件、错误与用量。这五处是两种协议形态差异最集中的地方，也是改造工作量和风险的主要来源。根据OpenAI官方迁移指南（2026年8月更新），Responses API定位为Agent和多模态场景的演进形态，但Chat Completions仍受支持且未设定弃用时间表。微软Azure OpenAI于2026年8月18日更新了Responses接入规范，DeepSeek-V4-Pro也在8月下旬原生支持，说明协议二元化已成为事实。本文按这五个条件逐项对照，给出保守迁移路径。

先给结论：什么场景该迁，什么场景继续用Chat Completions更省事

判断要不要跟随OpenAI API迁移，核心不是“新协议更先进”，而是你的业务形态是否匹配Responses的内置能力。需要多步agentic工具循环、服务端会话托管、内置工具（web search、file search、computer use）的项目，值得迁移；而纯单轮问答、需要跨多家供应商无缝切换、需要审计重放与自建缓存的链路，继续用Chat Completions更省事。OpenAI官方明确Chat Completions仍受支持且无弃用时间表，所以迁移不是“不得不做”的被动追赶，而是按场景取舍的工程决策。

差异一：请求入口与输入字段，OpenAI API迁移最先要改的几行

端点从/v1/chat/completions变为/v1/responses，这是迁移最直观的改动。输入参数上，messages数组被input字段替代，input可以传单一字符串或结构化items列表；系统级指令拆分到独立的instructions字段。这三处是入口层改动最集中的地方。建议封装函数签名不变、只换构造逻辑，把messages拼装和instructions提取收口到适配层。注意：任何未在OpenAI官方文档核实的字段，标注需核对，不要凭经验猜测。

差异二：多轮历史怎么表达，客户端拼装还是服务端接续

Responses API原生支持服务端会话状态持久化，通过store: true和previous_response_id自动接续历史，无需每轮全量重传messages。这对长会话场景能减少请求体体积。但需要注意，无状态全量提交在可复现性、可审计性和缓存可控性上更有优势。迁移判断建议：先保持客户端拼装，再按场景试服务端状态。如果你需要重放请求做审计或自建缓存，继续用全量提交更稳。

差异三：工具调用的声明与结果回传怎么映射

Responses API内置agentic loop，支持在单次请求中串联web search、file search、computer use与自定义function调用。而Chat Completions需要手写工具循环。对于已经在Chat Completions上写好工具循环的团队，迁移时需要在适配层把两种工具结果结构归一到内部统一数据模型。具体做法是定义内部工具调用/结果抽象，Chat Completions和Responses各自实现一套映射，业务层不直接依赖任一专有形态。如果你的主要场景只是自定义function，最小改动路径是仍然走Chat Completions，避免为迁而迁。

差异四：流式从delta增量变成事件流，消费代码怎么改

Responses API流式输出从Chat Completions扁平的choices[0].delta结构转变为强类型SSE事件流。客户端需监听response.created、response.output_item.added、response.output_text.delta、response.output_text.done及response.completed等事件。消费端要从“拼字符串”改成“按事件类型分发”。建议把两种流统一映射成内部token流事件，未知事件类型做容错忽略，避免因新事件导致崩溃。具体事件名以官方文档为准，需核对。

差异五：错误体与usage口径，账单和监控会不会对不上

迁移时务必核对错误结构与usage字段命名口径。如果两侧不一致，计费统计和告警面板会断裂。建议迁移前后对同一批请求双写统计、逐字段核对。具体字段名以官方文档为准，本文不臆造。调用Responses接口报404，通常来自端点路径未改，或供应商未开放该形态。注意区分是路径错误还是能力未开放。

保守迁移路径：抽一层协议适配器让两种形态共存

工程上最稳的OpenAI API迁移路径不是全量重写，而是抽一层协议适配器。业务层只依赖内部消息/工具/流式抽象，适配器分别实现Chat Completions与Responses两个后端，用配置开关切换。改造步骤：1) 定义内部协议抽象；2) 实现Chat Completions适配器（已有代码收口）；3) 实现Responses适配器；4) 配置开关默认指向Chat Completions；5) 灰度切流到Responses，随时可回滚。不要在业务代码里直接引用任一专有形态，这是保持灵活性的关键。

供应商只支持一种形态怎么办：能力探测与自动回退

跨供应商生态中，Chat Completions仍是兼容性最高的最小公分母。Azure OpenAI、DeepSeek-V4-Pro等已陆续支持Responses，但覆盖面不一。建议在启动时做一次性能力探测，命中不支持时自动回退到Chat Completions形态。NexAIX提供OpenAI Chat Completions兼容接口（base_url为https://api.nexaix.net/v1），支持流式输出、函数/工具调用与多轮对话，可作为多模型统一入口。这样协议试验只在适配层进行，主链路代码不动。返回体model字段对应实际执行模型；模型满载时返回标准429而非静默降级，便于迁移期做同一套回归eval。具体模型规格与可用性以NexAIX模型页和更新日志为准。如果你还在评估多模型接入，可参考OpenAI base_url 怎么改和OpenAI SDK兼容多轮对话怎么传。

迁移后必跑的回归项：工具调用链、长上下文、流式中断、超时与重试

完成适配层后，用一条真实生产链路跑回归清单，建议按下表逐项核对：

常见问题

迁移到Responses API要改哪些字段？

主要改三处：端点从/v1/chat/completions改为/v1/responses；messages数组换成input字段（字符串或items）；系统指令拆到instructions。其他如工具、流式、usage需额外适配，具体以官方文档为准。

Responses API和Chat Completions有什么区别？

核心区别在五个方面：端点、输入结构、状态管理（服务端store）、工具循环（内置agentic loop）、流式事件（强类型SSE）。Responses偏向Agent场景，Chat Completions更通用、无状态。

Responses API怎么传多轮历史消息？

两种方式：像Chat Completions那样全量传input（含历史消息），或启用store: true后用previous_response_id接续。前者可复现可审计，后者省请求体，建议按场景选。

Responses API流式事件怎么解析？

监听SSE事件：response.created、response.output_item.added、response.output_text.delta、response.output_text.done、response.completed，按事件类型分发处理，不要把事件当纯文本拼。

Responses API工具调用怎么写？

在input中声明工具定义，Responses会自动执行工具循环。自定义function时，适配层需将结果映射回内部模型。若有现成Chat Completions工具循环，可暂不迁移。

调用Responses接口报404是什么原因？

通常三个原因：端点路径仍用/v1/chat/completions；或供应商未开放Responses支持；或账号权限不足。先核对请求URL与供应商文档。

换成Responses API后usage字段还一样吗？

不一定，字段命名和口径可能变化。建议迁移前后双写统计，逐字段核对。未核实的字段以官方文档为准。