产品介绍
Responses API 是 OpenAI 于 2025 年 3 月发布的新一代模型调用接口，定位是 Chat Completions 的超集。它把 Chat Completions 的简洁易用与上一代 Assistants API 的工具与状态管理能力结合在一起；随着 Assistants API 宣布退役，Responses API 成为 OpenAI 官方推荐新集成使用的默认接口，也是构建 Agent 应用的主接口。
核心功能
- 无状态 / 有状态两种调用：既可像 Chat Completions 一样每次传入完整对话，也可通过 previous_response_id 让服务端自动承接上下文，跨轮次保留推理状态
- 内置工具：联网搜索（web search）、文件搜索（file search）、代码解释器（code interpreter）、电脑操作（computer use）、MCP 等服务端工具直接可用
- Agent 循环：「模型调用工具 → 返回结果 → 继续推理」的循环可由服务端代为执行，简化 Agent 开发
- 类型化输出：返回结构化的 output 数组，比 Chat Completions 的 choices 结构更易解析
使用说明
- 新集成直接使用 Responses API（endpoint：POST /v1/responses）；OpenAI 建议新的集成从 Responses API 开始
- 需要跨轮次记忆时传入 previous_response_id，由服务端保存上下文；无状态场景则保持轻量调用
- 原 Assistants API 的老项目按官方迁移指南迁移到 Responses API
- 使用前需在 OpenAI 平台创建 API Key 并完成计费配置