音色库接口
更新时间：2026-07-14
- 查询 API Key 绑定账号可用的音色库。
- 支持公共音色分页查询。
- 服务端根据 API Key 解析真实用户 ID，用户身份由 API Key 自动识别，无需传入 userId。
https://video-translation.viitor.com
Authorization: Bearer vt_live_xxx
OpenAPI 服务端会根据 API Key 解析真实用户 ID。
| 字段 | 类型 | 说明 |
|---|
code | Integer | 0 表示成功，非 0 表示失败 |
message | String | 返回信息 |
data | Object | 业务数据 |
分页接口的 data 结构：
| 字段 | 类型 | 说明 |
|---|
current | Integer | 当前页 |
size | Integer | 每页数量 |
total | Long | 总记录数 |
pages | Integer | 总页数 |
records | Array | 当前页记录 |
公共音色分页查询支持 sortType。
| 值 | 说明 |
|---|
0 | 默认排序 |
1 | 热门度 |
2 | 最多使用 |
3 | 发布时间 |
4 | 音色名称 |
6 | 生成最多字符数 |
- 请求 URL：
https://video-translation.viitor.com/openapi/v1/timbre/open/pageList - 请求方法：
POST - Content-Type：
application/json
| Header | 必填 | 类型 | 说明 |
|---|
Content-Type | 是 | String | application/json;charset=UTF-8 |
Accept | 建议 | String | application/json;charset=UTF-8 |
Authorization | 是 | String | Bearer <API_KEY> |
| 字段 | 类型 | 必填 | 说明 |
|---|
current | Integer | 否 | 当前页，默认 1 |
pageSize | Integer | 否 | 每页数量，默认 12，最大 400 |
timbreName | String | 否 | 音色名称，支持模糊查询 |
sortType | Integer | 否 | 排序类型，默认 0 |
| 字段 | 类型 | 说明 |
|---|
timbreId | Integer | 音色 ID |
timbreName | String | 音色名称 |
timbreEnglishName | String | 音色英文名称 |
voiceName | String | 音色名称标识，语音合成时可作为 voiceName 使用 |
vocalAudioUrl | String | 人声音频 URL |
avatarUrl | String | 音色头像 URL |
createTime | Long | 创建时间 |
common | Integer | 音色类型，1 表示公共音色 |
curl -X POST "https://video-translation.viitor.com/openapi/v1/timbre/open/pageList" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer vt_live_xxx" \
-d '{
"current": 1,
"pageSize": 10,
"timbreName": "博文老师",
"sortType": 1
}'
{
"code": 0,
"message": "OK",
"data": {
"current": 1,
"size": 10,
"total": 1,
"pages": 1,
"records": [
{
"timbreId": 16391,
"timbreName": "博文老师",
"timbreEnglishName": "NathanNarrator",
"voiceName": "CHINESE_SC_NARR_DOC",
"vocalAudioUrl": "https://tts-ap-singapore-1306922583.cos.accelerate.myqcloud.com/ref_audios/CHINESE_SC_NARR_DOC.wav",
"avatarUrl": "https://viitor-cdn.viitor.com/timbre_library/avatar/202509019/1f777c23ce07408d985ce3c63fc334f4.jpg",
"common": 1
}
]
}
}
| code | message | 说明 |
|---|
0 | OK | 成功 |
1103 | No Privilege | 账号不是 VIP 或无权限调用 |
2001 | Invalid Parameter | 参数非法 |
400001 | missing_api_key | 缺少 API Key |
400002 | invalid_api_key | API Key 无效 |
400003 | disabled_api_key | API Key 已禁用 |
400004 | expired_api_key | API Key 已过期 |
