# 文本对话（Anthropic 格式）

Anthropic 兼容的消息接口。网关内部会将请求翻译成上游格式（OpenAI 或原生 Anthropic），
响应也会翻译回标准 Anthropic 格式返回给调用方。

支持流式响应：当 `stream: true` 时，返回标准 Anthropic SSE 事件流，包含
`message_start`、`content_block_start`、`content_block_delta`、`message_stop` 等事件。

**必须携带请求头 `anthropic-version: 2023-06-01`。**

## POST /v1/messages

> 文本对话（Anthropic 格式）

Anthropic 兼容的消息接口。网关内部会将请求翻译成上游格式（OpenAI 或原生 Anthropic），
响应也会翻译回标准 Anthropic 格式返回给调用方。

支持流式响应：当 `stream: true` 时，返回标准 Anthropic SSE 事件流，包含
`message_start`、`content_block_start`、`content_block_delta`、`message_stop` 等事件。

**必须携带请求头 `anthropic-version: 2023-06-01`。**

### Authentication

`Authorization: Bearer tr-xxx`

### Request Body

Content-Type: `application/json`

- **model** `string` **(required)**  
  模型 ID，可通过 `GET /v1/models` 获取可用列表
- **max_tokens** `integer` **(required)**  
  最大输出 Token 数（必填）
- **messages** `object[]` **(required)**  
  对话消息列表，角色须交替为 user / assistant
- **messages[].role** ``user` | `assistant`` **(required)**  
  
- **messages[].content** `string | object[]` **(required)**  
  消息内容，可为字符串或内容块数组
- **system** `string`  
  系统提示词
- **stream** `boolean` (default: `false`)  
  是否启用流式响应
- **temperature** `number`  
  采样温度，范围 [0, 1]
- **stop_sequences** `string[]`  
  停止序列列表

### Response

- **id** `string`  
  消息唯一 ID，格式为 `msg_xxx`
- **type** ``message``  
  对象类型，固定为 `message`
- **role** ``assistant``  
  响应角色，固定为 `assistant`
- **content** `object[]`  
  内容块列表
- **content[].type** ``text`` **(required)**  
  
- **content[].text** `string` **(required)**  
  文本内容
- **model** `string`  
  实际使用的模型 ID
- **stop_reason** ``end_turn` | `max_tokens` | `stop_sequence` | `null``  
  停止原因
- **usage** `object`  
  
- **usage.input_tokens** `integer`  
  输入 Token 数量
- **usage.output_tokens** `integer`  
  输出 Token 数量

### Error Codes

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