音色列表查询
更新时间：2026-09-02
接口描述
获取用户已经创建的音色列表
POST
https://aip.baidubce.com/rest/2.0/speech/publiccloudspeech/v1/voice/clone/list
权限说明
调用本能力需要使用API Key进行鉴权认证。获取及使用API Key的流程请参考：APIKey鉴权说明文档
请求参数
示例代码
请求示例
curl --silent --location --request POST 'https://aip.baidubce.com/rest/2.0/speech/publiccloudspeech/v1/voice/clone/list?access_token=XXX' \
--data '{
"page": 1
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
status
integer
错误状态。0代表成功，其他为异常
可选
message
string
错误信息
可选
data
object {4}
音色列表信息
可选
显示子属性
隐藏子属性
total
integer
总数
可选
page
integer
页码
可选
page_size
integer
每页数量
可选
items
object {6}
音色列表
可选
显示子属性
隐藏子属性
voice_id
integer
训练后的音色 ID
可选
voice_name
string
音色名称
可选
voice_desc
string
音色说明
可选
lang
string
音色语种
可选
create_time
string
创建时间，Unix 时间戳
可选
status
integer
恒等于0
可选
评价此篇文章