Responses API

Responses API 是 OpenAI 平台文档里的一个接口分组，定位是「创建和管理模型响应」。它以 HTTP 端点的方式暴露能力，核心是 POST /responses 创建一条模型响应，周边还有取消、压缩对话、删除和获取单条响应等操作。

从返回结构看，一条响应的 output 是一个输出项数组，元素可以是 Message（发给模型或来自模型的消息），也可以是 Program（程序调用）和 ProgramOutput（程序输出）等类型，官方文档列出了其中若干形态。文本输出 ResponseOutputText 支持注解数组，涵盖文件引用 FileCitation、网址引用 URLCitation、容器文件引用 ContainerFileCitation 以及文件路径 FilePath 四种标注，每条标注都带索引位置。

开发者通常把 POST /responses 作为主调用入口，用 GET /responses/{response_id} 回查历史响应，用 POST /responses/compact 压缩较长的对话上下文，用 POST /responses/{response_id}/cancel 中止仍在进行的响应，用 DELETE /responses/{response_id} 删除不再需要的记录。

如果把大模型的调用封装进自有后端，Responses API 值得作为主入口：创建、查询、取消、删除、压缩五类操作齐全，输出结构里还带了网址引用、文件引用和 token 级 logprobs，做溯源展示或置信度过滤都有现成字段。压缩接口对多轮长对话尤其省事，不用自己写摘要逻辑。要注意的是，文档没有给出计费方式、速率限制和可用模型范围，这三项得去别处确认；删除后的数据保留策略也未说明，涉及合规留存的项目要谨慎。