語音合成 (WebSocket)

通過 WebSocket 連接實時生成語音，適用於聊天機器人等場景

WebSocket 實時語音合成接口

WebSocket 地址

wss://fishspeech.live/v1/tts/ws?token=YOUR_API_TOKEN

連接流程

1. 建立連接，並在 URL 中包含 API Key
2. 服務端事件：連接建立
3. 客戶端事件：初始化 TTS 配置
4. 服務端事件：服務就緒
5. 客戶端事件：發送文本
6. 服務端事件：返回音頻數據
7. 客戶端事件：停止處理

客戶端事件

// start 事件 - 初始化 TTS 配置
{
  "event": "start",
  "token": "YOUR_API_TOKEN",
  "request": {
    "reference_id": "your_model_id",  // 可選，模型 ID
    "latency": "normal",              // 可選，延遲模式："normal" 或 "balanced"
    "format": "mp3",                  // 可選，音頻格式："mp3" 或 "wav"
    "version": "s1"                   // 可選，TTS 版本："v1"、"v2"、"s1"
  }
}

// text 事件 - 發送文本
{
  "event": "text",
  "text": "要轉換的文本內容"
}

// stop 事件 - 停止當前處理
{
  "event": "stop"
}

服務器事件

// connected 事件 - 連接建立
{
  "event": "connected",
  "message": "WebSocket connection established"
}

// ready 事件 - 服務就緒
{
  "event": "ready",
  "message": "TTS service ready"
}

// processing 事件 - 正在處理文本
{
  "event": "processing",
  "text": "已處理的文本"
}

// audio 事件 - 音頻元數據
{
  "event": "audio",
  "format": "mp3",
  "text": "已處理的文本"
}

// 二進制數據 - 音頻格式
<二進制音頻數據>

// done 事件 - 處理完成
{
  "event": "done",
  "text": "已處理的文本"
}

// error 事件 - 發生錯誤
{
  "event": "error",
  "message": "錯誤信息",
  "text": "要轉換的文本內容"  // 可選
}

// stopped 事件 - 停止確認
{
  "event": "stopped"
}

在線調試

WebSocket 調試

模型 ID (可選)

TTS 版本

發送文本

狀態日誌

暫無日誌

狀態碼說明

狀態碼說明：
200 OK                  - 請求成功
400 Bad Request         - 請求參數錯誤
401 Unauthorized        - API Token 無效
403 Forbidden          - 禁止訪問
404 Not Found          - 資源不存在
413 Payload Too Large  - 上傳文件過大
429 Too Many Requests  - 請求頻率超限/積分不足
500 Server Error       - 服務器內部錯誤

錯誤響應格式：
{
  "error": string,      // 錯誤信息
  "details": string,    // 詳細錯誤信息（可選）
  "code": string       // 錯誤代碼（可選）
}