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 的区别

发展时间线

什么时候该用 Responses API？

如果你只是做普通聊天、简单问答、文本生成，/v1/chat/completions 依然很好用，也更容易迁移旧项目。

如果你需要下面这些能力，就更适合使用 /v1/responses：

• 需要模型使用工具，例如搜索、文件检索、外部系统调用。
• 需要处理图像、文件等多模态输入。
• 需要构建更完整的 Agent 工作流。
• 需要更自然地维护长期会话状态。
• 需要把函数调用、结构化输出和多步任务放在同一套接口里。

请求地址

https://api.maomaotoken.com/v1/responses

使用提示

如果你已有基于 /v1/chat/completions 的代码，不需要立刻全部迁移。

简单聊天继续使用 Chat Completions 即可；当你需要 Agent、工具调用、多模态或更复杂的上下文能力时，再考虑使用 Responses API。