查询视频生成任务状态
更新时间：2026-02-12
GET
https://qianfan.baidubce.com/beta/video/generations/qianfan-video
本接口可根据task_id和model查询生成视频的任务信息。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
task_id
string
此次视频生成的任务 ID。
必选
model
string
生成视频任务用的模型。
可选
请求结构
GET /beta/video/generations/qianfan-video?task_id={task_id}&model={model} HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>示例代码
curl
curl -X GET "https://qianfan.baidubce.com/beta/video/generations/qianfan-video?task_id=698c****ee577eeea76d2ae2" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408"返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
integer
错误码，请参见下文错误码说明。
必选
data
object {7}
返回数据体，包含任务相关信息。
必选
显示子属性
隐藏子属性
created_at
integer
任务创建时间，Unix 时间戳（毫秒）。
必选
task_id
string
任务 ID。
必选
task_result
object {1}
任务执行结果数据。
必选
显示子属性
隐藏子属性
videos
array
生成的视频结果列表。
必选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
duration
string
视频实际时长（秒）。
必选
id
string
视频资源 ID。
必选
url
string
视频下载/访问链接。
注意：资源有效期为 30 天，过期将自动清理，请及时转存。
必选
task_info
object
预留字段，默认为空对象 {}。
必选
显示子属性
隐藏子属性
task_status
string
任务当前状态。
枚举值：
● submitted：已提交（排队中）。
● processing：处理中。
● succeed：执行成功。
● failed：执行失败。
必选
task_status_msg
string
任务状态详情信息。
当状态为 failed 时，此处展示具体的失败原因。
必选
updated_at
integer
任务更新时间，Unix 时间戳（毫秒）。
必选
message
string
响应信息状态。
必选
request_id
string
请求 ID，用于日志追踪与问题排查。
必选
usage
object {3}
视频使用信息。
必选
显示子属性
隐藏子属性
model_name
string
模型名称。
必选
mode
string
视频生成模式。
必选
duration
string
视频时长（秒）。
必选
json
{
"code": 0,
"data": {
"created_at": 1770796857000,
"task_id": "698c373****77eeea76d2ae2",
"task_result": {
"videos": [
{
"duration": "5.041",
"id": "850472075826835532",
"url": "https://bj.bcebos.com/qianfan-modelbuilder/video/716d42bd78da4a93b56a8af6f61844c6/6888c2ac70964c558230e1901b88fda8/698c3739ee577eeea76d2ae2/video-nvvbhvdr36boc1neclte8ru3.mp4?authorization=bce-auth-v1%2FALTAKEDe5Wum0DnGzeUzScVC94%2F2026-02-11T11%3A47%3A11Z%2F86400%2F%2Fc52b18c2449fbb781b25088fe201106272d1f634fb0174b206a93dd1398036d1"
}
]
},
"task_info": {},
"task_status": "succeed",
"task_status_msg": "",
"updated_at": 1770796936000
},
"message": "SUCCEED",
"request_id": "as-hengdfhifd",
"usage": {
"model_name": "KO1",
"mode": "std",
"duration": "5.041"
}
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
本接口专有错误码如下：
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 0 | 请求成功 | - | - |
| 1100 | 账户异常 | 账户异常 | 检查账户配置信息 |
| 1200 | 请求参数非法 | 请求参数非法 | 检查请求参数是否正确 |
| 1201 | 请求参数非法 | 参数非法，如key写错或value非法 | 参考返回体中message字段的具体信息，修改请求参数 |
| 1202 | 请求参数非法 | 请求的method无效 | 查看接口文档，使用正确的request method |
| 1203 | 请求参数非法 | 请求的资源不存在，如模型 | 参考返回体中message字段的具体信息，修改请求参数 |
| 1300 | 触发策略 | 触发平台策略 | 检查是否触发平台策略 |
| 1301 | 触发策略 | 触发平台的内容安全策略 | 检查输入内容，修改后重新发起请求 |
| 5000 | 内部错误 | 服务器内部错误 | 稍后重试，或联系客服 |
| 5001 | 内部错误 | 服务器暂时不可用，通常是在维护 | 稍后重试，或联系客服 |
| 5002 | 内部错误 | 服务器内部超时，通常是发生积压 | 稍后重试，或联系客服 |
视频模型通用错误码
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 500 | internal_error | video_genration_interal_error | video generation service interal error |
| 400 | invalid_request_error | invalid_lipsync_argument | |
| 429 | rate_limit_exceeded | video_genration_concurrency_exceeded | Rate limit reached for Concurrency |
| 403 | unsafe_request | video_genration_prompt_unsafe | the content of prompt field is unsafe |