查询自定义音色生成任务列表状态
更新时间：2026-04-10
GET
https://qianfan.baidubce.com/beta/video/generations/qianfan-video/list?model={model}&pageNum={pageNum}&pageSize={pageSize}
查询自定义音色列表，返回分页的自定义音色任务数据。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
model
string
用于查询列表自定义音色的模型名称，固定值：Custom-Voice。
必选
pageNum
integer
页码，取值范围：[1, 1000]，默认值：1。
可选
pageSize
integer
每页数据量，取值范围：[1, 1000]，默认值：30。
可选
请求结构
GET /beta/video/generations/qianfan-video/list?model={model}&pageNum={pageNum}&pageSize={pageSize} HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>示例代码
请求示例
curl -X GET "https://qianfan.baidubce.com/beta/aigc/generations/qianfan-elements?model=Custom-Voice&pageNum=1&pageSize=30" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408"返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
integer
错误码，具体见下文错误码。
必选
data
object {8}
返回数据体，包含任务相关信息。
必选
显示子属性
隐藏子属性
task_id
string
任务ID，与传入的参数一致。
必选
task_info
object {0}
预留参数。
必选
显示子属性
隐藏子属性
暂无参数
task_result
object {1}
任务结果信息。
必选
显示子属性
隐藏子属性
voices
array
生成的自定义音色列表。
必选
显示子属性
隐藏子属性
items
object {4}
显示子属性
隐藏子属性
status
string
生成自定义音色状态。
必选
trial_url
string
生成自定义音色的URL。
必选
voice_id
string
生成的自定义音色ID。
必选
voice_name
string
生成的自定义音色名称。
必选
task_status
string
任务状态
submitted：已提交processing：处理中succeed：成功failed：失败
必选
task_status_msg
string
任务状态信息，当任务失败时展示失败原因。
必选
created_at
integer
任务创建时间，Unix时间戳，单位毫秒。
必选
updated_at
integer
任务更新时间，Unix时间戳，单位毫秒。
必选
usage
object {2}
用量统计信息。
必选
显示子属性
隐藏子属性
mode
string
实际使用的自定义音色生成模式。
必选
credits
string
本次任务实际消耗的点数。
必选
message
string
错误信息。
必选
request_id
string
请求ID，用于跟踪请求、排查问题。
必选
返回示例
{
"code": 0,
"data": [
{
"task_id": "69d5ca3xxxxxxb3e6de48be8",
"task_result": {
"voices": [
{
"owned_by": "",
"status": "succeed",
"trial_url": "https://xxxxxx",
"voice_id": "87069xxxxxx7645332",
"voice_name": "qatestxxx"
}
]
},
"task_info": {},
"task_status": "succeed",
"task_status_msg": "",
"usage": {
"mode": "std",
"credits": 0.05
},
"created_at": 177xxxxxx334,
"updated_at": 177xxxxxx9328
},
{
"task_id": "69d4a74bxxxxxx86a6ea9a8",
"task_result": {
"voices": [
{
"owned_by": "",
"status": "succeed",
"trial_url": "https://xxxxxx",
"voice_id": "8703xxxxxx4475576",
"voice_name": "qatestxxx"
}
]
},
"task_info": {},
"task_status": "succeed",
"task_status_msg": "",
"usage": {
"mode": "std",
"credits": 0.05
},
"created_at": 177xxxxxx0744,
"updated_at": 177xxxxxx7456
}
],
"message": "",
"request_id": "as-xxxxxxhvr2"
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
视频模型通用错误码
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 500 | internal_error | video_generation_internal_error | video generation service internal error |
| 400 | invalid_request_error | invalid_lipsync_argument | |
| 429 | rate_limit_exceeded | video_generation_concurrency_exceeded | Rate limit reached for Concurrency |
| 403 | unsafe_request | video_generation_prompt_unsafe | the content of prompt field is unsafe |
评价此篇文章