查询视频生成任务
更新时间：2025-08-26
使用本接口，查询使用百度蒸汽机（MuseSteamer)模型发起的视频生成任务进展。
GET
https://qianfan.baidubce.com/video/generations
根据task_id查询使用百度蒸汽机（MuseSteamer)发起的特定视频生成任务生成。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
task_id
string
需要查询的视频生成任务的task_id。
必选
请求结构
GET /video/generations?task_id={task_id} HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string示例代码
请求示例
curl 'https://qianfan.baidubce.com/video/generations?task_id=xq***k9' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' 返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
id
string
本次请求的唯一标识，可用于排查问题。
可选
task_id
string
视频生成任务ID，用于查询视频生成任务进展或问题排查。
可选
model
string
本次请求所使用的model。
可选
content
object {1}
视频生成任务完成后输出的内容。
可选
显示子属性
隐藏子属性
video_url
string
生成视频的URL，URL有效期24小时，视频内容最多保存30天。
可选
status
string
任务状态，枚举值：pending（已创建）、queued（排队中）、running（运行中）、succeeded（生成成功）、failed（生成失败）。
可选
duration
integer
生成视频的时长。
可选
width
string
生成视频的宽度。
可选
height
string
生成视频的高度。
可选
created_at
string
任务创建时间，Unix时间戳、单位ms。
可选
updated_at
string
任务更新时间，Unix时间戳、单位ms。
可选
响应示例
{
"id": "as-***",
"task_id": "tdsx***k9",
"model": "musesteamer-2.0-turbo-i2v-audio",
"status": "succeeded",
"created_at": 1743414619,
"updated_at": 1743414673,
"content": {
"video_url": "https://fc-***.mp4"
},
"duration": 5,
"width": 1280,
"height": 704
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
本接口专有错误码如下：
| http状态码 | type | code | message |
|---|---|---|---|
| 500 | internal_error | video_generation_internal_error | video generation service internal error |
| 400 | invalid_request_error | invalid_video_generation_argument | xxx |
| 429 | rate_limit_exceeded | video_generation_concurrency_exceeded | Rate limit reached for Concurrency |
| 403 | unsafe_request | video_generation_prompt_unsafe | The input image/prompt is unsafe. |
| 403 | unsafe_request | video_generation_output_unsafe | The output is unsafe. |
| 501 | internal_error | video_generation_risk_system_error | risk control system internal error |