Responses 基础接口
OpenAI Responses 风格入口，用同一套请求结构承载文本、多模态输入、工具、推理和事件流。
请求格式
使用 application/json。必须包含 model 和 input。input 支持字符串，也支持包含 role、content 的数组。
适用位置
- 新项目按 Responses 接入。
- 同一请求中处理文本、图片输入、工具和事件流。
- 后续需要 reasoning、web search 或更复杂输出结构的模块。
验证顺序
- 用
model+input发送基础请求。 - 返回正常后，再加
stream、tools、reasoning。 - 已经大量使用 Chat Completions 的项目，按模块并行迁移。
读取结果
非流式请求返回响应对象；流式请求返回 Responses 事件流。接入时按事件类型处理文本增量、工具调用、完成和错误事件。
POST
Authorizations
在请求头中传入：Authorization: Bearer sk-...
Body
application/json
OpenAI Responses 请求结构，可承载文本、多模态输入、工具、推理和事件流。
要调用的模型 ID。
输入内容。可传字符串，也可传包含 role 和 content 的输入数组；多模态内容放在 content 数组中。
是否开启事件流返回。true 时客户端按 Responses 事件类型逐段读取。
工具定义数组。Responses 在同一请求结构中承载函数工具、搜索等工具。
推理设置，例如 effort。仅推理模型读取该字段。
文本输出设置。结构化输出、格式约束等会读取该字段。
系统级指令。可放入角色、风格、边界和长期约束。
Response
响应结果
The response is of type object.