OpenAI Responses API 是 OpenAI 自 2025 年 3 月起提供的统一接口(端点 /v1/responses),面向智能体应用。相较 Chat Completions,它在多轮对话间保留模型推理状态,官方称在 TAUBench 上约有 5% 提升,并改善缓存利用。
主要能力与用法:通过 conversation ID 自动管理会话状态,也支持手动维护 history;内置服务端工具包括代码解释器、文件搜索、网络搜索、图像生成以及 MCP 外部工具连接;输出为多形态(message、reasoning、工具调用等),便于调试与审计;支持 background 模式处理长任务。
依赖与快速开始:需要 API 密钥(环境变量 OPENAI_API_KEY),Node.js 使用 openai@5.19.1+,可 npm install openai 后调用 openai.responses.create;也可在 Cloudflare Workers 等环境直接用 fetch 调用。
限制:API 密钥必须仅在服务端使用;MCP 授权令牌不会由 API 存储,需每次请求携带;标准模式超时约 60 秒,background 模式约 10 分钟;官方给出的文件大小上限为 512MB。具体价格与配额等资料暂未提供。