# 端到端实时语音对话（WebSocket）

**WebSocket 端点，非普通 HTTP**：`wss://api.xrtoken.net/v1/realtime?model=doubao-realtime`。
一个长连接完成「录音 → 识别 → 大模型 → 语音回答」全链路，自带 VAD 断句、打断、上下文。

**鉴权**：服务端用 `Authorization: Bearer <key>` header；浏览器无法带 header，用 `Sec-WebSocket-Protocol: ["xrtoken.bearer", "<key>"]` 携带。

建连后走火山端到端实时语音二进制协议（`StartConnection` → `StartSession` → `TaskRequest` 音频流 → `ASRResponse`/`ChatResponse`/`TTSResponse` 事件）。二进制帧编解码、事件流程详见专门的对接文档。

**计费**：按对话实际 token 成本价（输入文本/音频、输出文本/音频分别计价），连接结束按真实用量结算。纯静音不计费；3 分钟无交互自动断开。

## GET /v1/realtime

> 端到端实时语音对话（WebSocket）

**WebSocket 端点，非普通 HTTP**：`wss://api.xrtoken.net/v1/realtime?model=doubao-realtime`。
一个长连接完成「录音 → 识别 → 大模型 → 语音回答」全链路，自带 VAD 断句、打断、上下文。

**鉴权**：服务端用 `Authorization: Bearer <key>` header；浏览器无法带 header，用 `Sec-WebSocket-Protocol: ["xrtoken.bearer", "<key>"]` 携带。

建连后走火山端到端实时语音二进制协议（`StartConnection` → `StartSession` → `TaskRequest` 音频流 → `ASRResponse`/`ChatResponse`/`TTSResponse` 事件）。二进制帧编解码、事件流程详见专门的对接文档。

**计费**：按对话实际 token 成本价（输入文本/音频、输出文本/音频分别计价），连接结束按真实用量结算。纯静音不计费；3 分钟无交互自动断开。

### Authentication

`Authorization: Bearer tr-xxx`

### Error Codes

- `101`: WebSocket 协议切换成功，进入实时对话
- `401`: 
- `402`: