Responses 接口介绍
OpenAI 在 2025 年推出了新的 Responses API。它可以理解为 Chat Completions 之后的新一代接口形态，更适合多模态输入、工具调用、Agent 工作流和长期会话场景。
在 MaomaoToken 中，如果你需要使用 OpenAI 新版请求格式，可以优先参考这一组文档。
简介
Responses API 的目标是把文本、图像、工具调用、函数调用、上下文管理等能力放进更统一的接口中。相比传统 /v1/chat/completions，它不只是「让模型回复一句话」，而是更适合构建具备工具能力的 AI 应用。
主要能力包括：
- 支持文本和图像输入，并返回文本输出。
- 支持有状态交互，可以将先前响应继续作为下一次输入。
- 支持文件搜索、网络搜索、计算机使用等内置工具能力。
- 支持函数调用，让模型访问外部系统和业务数据。
为什么会有 /v1/responses 接口？
- 能力更统一在传统对话生成之外，进一步整合结构化输出、工具调用、多模态输入和 Agent 工作流。
- 开发更简单减少手动编写 glue code 的工作量，让工具调用、模型输出和后续处理更集中。
- 面向 Agent更适合构建带工具交互、长期上下文和复杂任务执行能力的 AI 应用。
和 Chat Completions 的区别
| 对比项 | /v1/chat/completions | /v1/responses |
|---|---|---|
| 定位 | 经典对话生成接口 | 新一代统一响应接口 |
| 状态管理 | 通常需要每次手动传入完整历史消息 | 可通过 store、previous_response_id 等方式维护上下文 |
| 工具集成 | 主要依赖 function calling，工具流程由开发者管理 | 更强调内建工具和 Agent 式调用流程 |
| 多模态能力 | 以文本对话为主，部分模型支持图像输入 | 更统一地支持文本、图像、工具调用等能力 |
| 流式输出 | 支持文本流式输出 | 支持更丰富的流式事件 |
| 推荐场景 | 简单聊天、文本生成、兼容旧项目 | Agent、工具调用、多模态、长期会话应用 |
发展时间线
| 时间 | 重要事件 |
|---|---|
| 2025 年 3 月 | OpenAI 发布 Responses API，并将其定位为构建 Agent 应用的新接口基础。 |
| 2025 年 3 月后 | Responses API 开始支持 web search、file search、computer use 等工具能力。 |
| 2025 年 5 月 | Responses API 继续扩展工具集和企业开发能力，例如图像生成、代码解释、MCP 支持等方向。 |
| 2025 年 7 月 | Azure OpenAI 相关版本开始提供 Responses API 预览能力。 |
什么时候该用 Responses API？
如果你只是做普通聊天、简单问答、文本生成，/v1/chat/completions 依然很好用，也更容易迁移旧项目。
如果你需要下面这些能力，就更适合使用 /v1/responses：
- 需要模型使用工具，例如搜索、文件检索、外部系统调用。
- 需要处理图像、文件等多模态输入。
- 需要构建更完整的 Agent 工作流。
- 需要更自然地维护长期会话状态。
- 需要把函数调用、结构化输出和多步任务放在同一套接口里。
请求地址
https://api.maomaotoken.com/v1/responses使用提示
如果你已有基于 /v1/chat/completions 的代码，不需要立刻全部迁移。简单聊天继续使用 Chat Completions 即可；当你需要 Agent、工具调用、多模态或更复杂的上下文能力时，再考虑使用 Responses API。
Responses API 的具体参数、模型支持范围和工具能力，会随模型版本和平台开放情况变化。实际调用时，请以 MaomaoToken 控制台可用模型和接口支持情况为准。 :