音色管理
更新时间：2025-10-28
音色列表查询的接口
接口描述
音色列表查询，可查询系统音色和复刻的音色
请求语法
JSON
1GET /api/v{version}/timbres HTTP/1.1
2host: rtc-aiagent.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>请求头域
除公共头域外，无其它特殊头域。
请求参数
| 名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| pageNo | Integer | 是 | RequestBody | 起始页 |
| pageSize | Integer | 是 | RequestBody | 每页的最大值（不超过100） |
| clone | Boolean | 是 | RequestBody | 系统音色和复刻音色的标签，false：系统音色，true：复刻音色 |
请求示例
JSON
1PUT /api/v1/timbres?pageNo=1&pageSize=2&clone=false HTTP/1.1
2host: rtc-aiagent.baidubce.com
3content-type: application/json
4authorization: {bce-authorization-string}
5x-bce-request-id: {bce-request-id}响应参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| pageNo | Integer | 当前页 |
| pageSize | Integer | 当前页的音色数量 |
| totalCount | Integer | 总的音色数量 |
| data | Object | 音色的详细数据 |
| + timbreId | Long | 音色id |
| + name | String | 音色名称 |
| + createTime | String | 创建时间 |
| + status | String | 音色的状态，TRAINED：已训练，UNTRAINED：未训练 |
| + language | String | 音色支持的语言，chinese：中文，english：英文，japanese：日语 |
| + auditionAudioUrl | String | 音色试听文件的url(有效期1小时) |
| + auditionBackgroundUrl | String | 音色背景图的url(有效期1小时)，只有系统音色有 |
响应示例
JSON
1HTTP/1.1 200 OK
2x-bce-request-id: b06a9214-04d6-4a08-9f5d-966b04604cfb
3date: Mon, 05 Sep 2022 03:25:43 GMT
4transfer-encoding: chunked
5content-type: application/json;charset=UTF-8
6cache-control: no-cache
7{
8 "pageNo": 1,
9 "pageSize": 2,
10 "totalCount": 10,
11 "data": [
12 {
13 "timbreId": 1000000,
14 "name": "呆萌奶娃",
15 "createTime": "2025-06-25 15:26:29",
16 "status": "TRAINED",
17 "language": "chinese",
18 "auditionAudioUrl": "",
19 "auditionBackgroundUrl": ""
20 },
21 {
22 "timbreId": 1000001,
23 "name": "活力少年",
24 "createTime": "2025-06-25 15:26:29",
25 "status": "TRAINED",
26 "language": "chinese",
27 "auditionAudioUrl": "",
28 "auditionBackgroundUrl": ""
29 }
30 ]
31}