用途:Responses API(/v1/responses)是 OpenAI 面向智能体应用推出的统一接口,相较 Chat Completions 提供有状态会话与结构化“推理+行动”循环。依赖 openai@5.19.1+(Node.js)或 fetch API(如 Cloudflare Workers)。
主要能力:跨轮保留推理状态(据称在 TAUBench 上约提升 5%);通过 conversation ID 自动管理状态;服务端托管工具,包括代码解释器、文件检索、网络搜索、图像生成与 MCP;返回多态输出(message、reasoning、工具调用等);缓存利用率据称提升 40–80%;支持后台模式处理长任务;提供推理摘要。
使用方式:设置环境变量 OPENAI_API_KEY;安装 npm install openai,创建客户端后调用 openai.responses.create({ model: 'gpt-5', input: '...' }),读取 response.output_text;边缘环境可直接 POST 到 https://api.openai.com/v1/responses。可创建 conversation 并用其 ID 续接,或手动维护历史(含 store 选项)。工具以 tools 数组声明,如 { type: 'code_interpreter' }、{ type: 'file_search', file_ids: [...] }、{ type: 'web_search' }、{ type: 'image_generation' },MCP 需提供 server_label、server_url,OAuth 令牌须每次请求携带。
适用场景:需要多轮推理连续性、内置工具、MCP 外部集成或后台长任务的智能体应用。
限制:API 密钥须仅服务端使用;标准模式超时约 60 秒,后台模式最长约 10 分钟;文件检索单文件上限 512MB;MCP 授权令牌不由 API 存储;具体计费、配额与模型支持范围暂未提供。