XRToken API 文档

端到端实时语音对话(WebSocket)

API 配置
保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。
Base: api.xrtoken.net

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

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

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

计费:按对话实际 token 成本价(输入文本/音频、输出文本/音频分别计价),连接结束按真实用量结算。纯静音不计费;3 分钟无交互自动断开。

GET
/v1/realtime

Authorization

BearerAuth
AuthorizationBearer <token>

API 密钥认证(OpenAI 格式)。在 Authorization 请求头中传入:

Authorization: Bearer tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

In: header

Response Body

application/json

application/json

curl -X get "https://api.xrtoken.net/v1/realtime"
Empty
{
  "error": "invalid or missing API key",
  "type": "auth_error"
}
{
  "error": "insufficient balance -- please top up or upgrade your plan",
  "type": "billing_error"
}