排障指南 / GUIDE
OpenAI Responses API 的 background、轮询、Webhook、cancel、store 和 ZDR 有什么区别?
直接答案
OpenAI Responses API 的 background、轮询、Webhook、cancel、store 和 ZDR 有什么区别?
症状、差异与判断依据
机制 解决的问题 调用方向 是否代表任务成功
-- --- --- ---
background 避免长任务绑定单次连接 客户端创建请求 否
polling 主动查询当前状态 客户端到 OpenAI 否
webhook 接收状态事件通知 OpenAI 到你的端点 否
排障步骤与验证
cancel 请求终止后台响应 客户端到 OpenAI 否
store 控制轮询期后是否保留 创建参数 否
ZDR 项目级数据保留控制 平台策略 否
只有读取最终 Response 对象并确认终态、错误与输出,才能判断业务结果。收到 HTTP 2xx 或 Webhook 并不自动等于模型任务完成。
创建 Response 时设置 background: true,OpenAI 会异步执行可能持续较长时间的任务,并立即返回可用于后续查询的 Response 对象。官方文档将它定位为避免长任务受客户端连接超时或断开影响的执行方式。
后台模式不会让模型本身必然更快,也不会自动重试你的业务流程。它主要把“保持一条请求连接”等待结果,改成“创建任务后再查询或接收通知”。
短且延迟可控的交互可使用普通前台响应,调用完成后直接处理结果。预计耗时数分钟、使用复杂工具或客户端网络不稳定的任务,更适合后台模式。
官方与规范资料
OpenAI API 错误处理OpenAI 官方文档
Responses API:Create a model responseOpenAI 官方文档