# 响应（Responses API）

OpenAI Responses API 兼容端点，透传至上游。支持流式（SSE）与非流式响应。

与 `/v1/chat/completions` 的区别：请求用 `input` 代替 `messages`、`max_output_tokens`
代替 `max_tokens`；流式为 typed events，以 `response.completed` 事件（含 `usage`）结束。

任意 chat 类模型均可调用；若上游不支持 Responses API，将透传上游错误并退费。
Codex 等仅支持 Responses API 的客户端可直接把 base_url 指向本网关。

## POST /v1/responses

> 响应（Responses API）

OpenAI Responses API 兼容端点，透传至上游。支持流式（SSE）与非流式响应。

与 `/v1/chat/completions` 的区别：请求用 `input` 代替 `messages`、`max_output_tokens`
代替 `max_tokens`；流式为 typed events，以 `response.completed` 事件（含 `usage`）结束。

任意 chat 类模型均可调用；若上游不支持 Responses API，将透传上游错误并退费。
Codex 等仅支持 Responses API 的客户端可直接把 base_url 指向本网关。

### Authentication

`Authorization: Bearer tr-xxx`

### Request Body

Content-Type: `application/json`

- **model** `string` **(required)**  
  模型 ID，可通过 `GET /v1/models` 获取可用列表
- **input** `string | object[]` **(required)**  
  输入内容。可为字符串，或 OpenAI Responses 格式的输入项数组
- **stream** `boolean` (default: `false`)  
  是否启用流式响应（SSE，typed events）
- **max_output_tokens** `integer`  
  最大输出 Token 数

### Response

- **id** `string`  
  响应 ID
- **object** `string`  
  
- **status** `string`  
  状态，如 `completed`
- **output** `object[]`  
  输出项数组（文本、图像生成调用等）
- **usage** `object`  
  
- **usage.input_tokens** `integer`  
  输入 Token 数量
- **usage.output_tokens** `integer`  
  输出 Token 数量
- **usage.total_tokens** `integer`  
  总 Token 数量

### Error Codes

- `400`: 
- `401`: 
- `402`: 
- `429`: 
- `502`: