查询视频生成任务列表
更新时间：2025-11-07
GET
https://qianfan.baidubce.com/video/generations/list
批量查询视频生成任务列表接口。
本接口支持查询最近7天精确到秒的历史数据，采用UTC时间戳计算，返回数据时间戳范围为 [T-7天, T)。
支持模型列表
- musesteamer-2.0-turbo-i2v-effect
- musesteamer-2.0-turbo-i2v
- musesteamer-2.0-pro-i2v
- musesteamer-2.0-lite-i2v
- musesteamer-2.0-turbo-i2v-audio
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
page_num
integer
分页参数，返回结果页码，取值范围[1, 500]
与过滤参数同时填写时，返回交集结果
可选
page_size
integer
分页参数，每页返回的数据条数，取值范围[1, 500]
与过滤参数同时填写时，返回交集结果
可选
filter.status
string
过滤参数，根据任务状态进行过滤
与分页参数同时填写时，返回交集结果
- Created：已创建
- Queued：排队中
- Running：运行中
- Success：生成成功
- Failure：生成失败
- Terminated：任务已取消
可选
filter.model_name
string
过滤参数，根据任务使用的模型名称进行过滤
与分页参数同时填写时，返回交集结果
可选
filter.task_ids
array
根据视频生成任务ID进行过滤，可同时传入多个ID，多个ID间通过 & 连接
注意：同时填写page_num和page_size时，忽略filter.task_id选项
可选
显示子属性
隐藏子属性
items
string
请求结构
GET /video/generations/list HTTP/1.1
Host: qianfan.baidubce.com
Authorization: Bearer <API key>
示例代码
请求示例
curl -X GET "https://qianfan.baidubce.com/video/generations/list?page_num=1&page_size=100&filter.status=Success" \
-H "Authorization: Bearer <API key>"返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
id
string
本次请求的唯一标识，用于排查问题
必选
total
integer
符合筛选条件的任务数量
必选
items
object {10}
返回结果信息
必选
显示子属性
隐藏子属性
task_id
string
视频生成任务ID
可选
model
string
任务使用的模型名称和版本，格式为“模型名称-版本“
可选
status
string
任务状态
- Created：已创建
- Queued：排队中
- Running：运行中
- Success：生成成功
- Failure：生成失败
- Terminated：任务已取消
可选
error
anyOf {2}
多选一，只需要符合下列任意一组子节点
错误提示信息
可选
显示子属性
隐藏子属性
error
string
任务成功时返回null
error
object {0}
任务失败时返回具体错误数据
显示子属性
隐藏子属性
暂无参数
created_at
integer
任务创建时间的Unix时间戳（单位：秒）
可选
updated_at
integer
任务当前状态更新时间的Unix时间戳（单位：秒）
可选
content
object {1}
视频生成任务完成时输出，包含生成视频的下载url
可选
显示子属性
隐藏子属性
video_url
string
视频生成的url
可选
height
string
生成视频的高度
可选
width
string
生成视频的宽度
可选
duration
integer
生成视频的时长（单位：秒）
可选
响应示例
{
"id": "271****794",
"total": 1,
"items": [
{
"task_id":"67c9*****8c05a4",
"model":"musesteamer-2.0-i2v",
"status":"Success",
"created_at":"1718049470",
"updated_at":"1718049470",
"content":{
"video_url":"https://example.com/videos/video-78901.mp4"，
}，
"height":"",
"width":""
}，
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
本接口专有错误码如下：
| HTTP状态码 | 错误类型 | 错误码 | 错误信息 | 说明 |
|---|---|---|---|---|
| 400 | invalid_request_error | invalid_argument | Required startTime or endTime parameter String is not present | 缺少开始或结束时间 |
| 400 | invalid_request_error | Invalid_time_format | Invalid time format | 时间格式无效（必须符合 ISO 8601 标准） |
| 400 | invalid_request_error | Invalid_time_value | Start time cannot be later than end time or earlier than 7 days ago | 开始时间不能晚于结束时间或早于 7 天前 |