XRToken API 文档

语音合成 WebSocket 双向流(火山原生协议透传,边生成边合成)

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

WebSocket 端点,非普通 HTTPwss://api.xrtoken.net/v1/audio/speech/bidirection?model=seed-tts-2.0

建连后走火山 SAMI 双向语音合成二进制协议,适合 LLM 边生成文本边合成语音 的低延迟 场景:StartConnectionStartSessionTaskRequest(可发送 N 次,每次追加一段 增量文本)→ FinishSessionFinishConnection;也支持 CancelSession 中途打断。 帧格式与火山官方完全一致,仅需更换域名与鉴权 key,可直接复用火山官方 Demo 客户端 代码对接。

鉴权:服务端用 Authorization: Bearer <tr-key>X-Api-Key: <tr-key>;浏览器 无法带 header 时用 Sec-WebSocket-Protocol: ["xrtoken.bearer", "<tr-key>"] 携带, 不走 URL query。

选模型?model= 优先;X-Api-Resource-Id header 兜底。

计费:按文本字符数计费(含标点),context_texts 语音指令不计费,结算以上游 返回的 usage.text_words 为准(未回传时按客户端实发文本字符数兜底)。

并发:单 key 最多 10 路并发流。

GET
/v1/audio/speech/bidirection

Authorization

BearerAuth
AuthorizationBearer <token>

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

Authorization: Bearer tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

In: header

Query Parameters

model?string

语音合成模型 / 渠道 ID

Response Body

application/json

application/json

application/json

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