# Responses 基础接口

`POST /v1/responses`

OpenAI Responses 风格入口，用同一套请求结构承载文本、多模态输入、工具、推理和事件流。

## 请求格式
使用 `application/json`。必须包含 `model` 和 `input`。`input` 支持字符串，也支持包含 role、content 的数组。

## 适用位置
- 新项目按 Responses 接入。
- 同一请求中处理文本、图片输入、工具和事件流。
- 后续需要 reasoning、web search 或更复杂输出结构的模块。

## 验证顺序
1. 用 `model` + `input` 发送基础请求。
2. 返回正常后，再加 `stream`、`tools`、`reasoning`。
3. 已经大量使用 Chat Completions 的项目，按模块并行迁移。

## 读取结果
非流式请求返回响应对象；流式请求返回 Responses 事件流。接入时按事件类型处理文本增量、工具调用、完成和错误事件。

Tags: Responses