# 文本对话

OpenAI 兼容的聊天补全接口，支持流式（SSE）与非流式响应。

当 `stream: true` 时，响应为 `text/event-stream` 格式的 Server-Sent Events 流。

## POST /v1/chat/completions

> 文本对话

OpenAI 兼容的聊天补全接口，支持流式（SSE）与非流式响应。

当 `stream: true` 时，响应为 `text/event-stream` 格式的 Server-Sent Events 流。

### Authentication

`Authorization: Bearer tr-xxx`

### Request Body

Content-Type: `application/json`

- **model** `string` **(required)**  
  模型 ID，可通过 `GET /v1/models` 获取可用列表
- **messages** `object[]` **(required)**  
  对话历史消息列表
- **messages[].role** ``system` | `user` | `assistant`` **(required)**  
  消息角色
- **messages[].content** `string` **(required)**  
  消息内容
- **stream** `boolean` (default: `false`)  
  是否启用流式响应（SSE）
- **temperature** `number`  
  采样温度，范围 [0, 2]，值越高输出越随机
- **max_tokens** `integer`  
  最大输出 Token 数
- **top_p** `number`  
  核采样概率，范围 (0, 1]

### Response

- **id** `string`  
  请求唯一 ID
- **object** ``chat.completion``  
  对象类型，固定为 `chat.completion`
- **model** `string`  
  实际使用的模型 ID
- **choices** `object[]`  
  生成结果列表
- **choices[].index** `integer`  
  候选结果索引
- **choices[].message** `object`  
  
- **choices[].finish_reason** ``stop` | `length` | `content_filter` | `null``  
  停止原因
- **usage** `object`  
  
- **usage.prompt_tokens** `integer`  
  输入 Token 数量
- **usage.completion_tokens** `integer`  
  输出 Token 数量
- **usage.total_tokens** `integer`  
  总 Token 数量

### Error Codes

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