端到端实时语音对话(WebSocket)
API 配置
保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。
Base: api.xrtoken.net
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 分钟无交互自动断开。
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"
}