查询音频库

since 4.0.19

GET /v1/stream/voice/clip

本地音频库清单（t_voice_clip），并标注转码后的 WAV 是否已在 voice.localDir。用于客户端试听、选择 voice（字符串，音频编号）。

• 鉴权：先 POST /login，头 X-Auth-Token。无独立语音权限，与下发接口相同。
• 按 voiceId 升序。
• fileReady：本地 {voiceId}.wav 是否已存在且非空。未就绪时下载接口返回 404。

功能未启用（无 voice 配置）时接口不可用。

请求

GET https://wx.gratour.info:7200/v1/stream/voice/clip
Content-Type: application/json
X-Auth-Token: HrWwReOAQ9WdLnJQ1JYivA

无请求参数。

应答

{
  "errCode": 0,
  "count": 3,
  "data": [
    {
      "voiceId": "01265242-cc33-4c90-9b27-af7de0be079a",
      "name": "请系好安全带",
      "fmt": "mp3",
      "fileName": "01265242-cc33-4c90-9b27-af7de0be079a.wav",
      "size": 12345,
      "syncTm": 1775450843601,
      "fileReady": true
    }
  ]
}

应答实体属性

属性	类型	说明
voiceId	string	语音编号，对应下发接口的 voice
name	string	名称（远程清单，可空）
fmt	string	源格式 mp3 / wav
fileName	string	本地文件名
size	long	源文件大小（字节，可空）
syncTm	long	同步时间 epoch millis
fileReady	boolean	本地转码 WAV 是否可试听

试听见 下载/试听语音。