查询视频生成任务状态
更新时间：2026-03-25
GET
https://qianfan.baidubce.com/beta/video/generations/qianfan-video
通过task id查询生成视频的任务状态。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
task_id
string
创建视频接口生成的任务ID。
必选
model
string
创建当前任务的模型。
可选
请求结构
GET /beta/video/generations/qianfan-video?task_id=xxx&model=xxx HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>示例代码
基础调用
curl -X GET "https://qianfan.baidubce.com/beta/video/generations/qianfan-video?task_id=xxx" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408"返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
log_id
string
日志ID，用于问题排查。
可选
id
string
任务ID。
可选
status
string
任务状态，标识当前任务所处阶段。
created创建成功queueing任务排队中processing任务处理中success任务成功failed任务失败
可选
err_code
string
错误码，具体⻅错误码表。
可选
creations
array
生成内容。
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
id
string
生成视频ID。
可选
url
string
⽣成视频URL。
可选
cover_url
string
⽣成视频封面。
可选
usage
object {4}
视频关键信息。
可选
显示子属性
隐藏子属性
model
string
生成视频的模型名称。
可选
duration
string
生成视频的时长。
可选
resolution
string
生成视频的分辨率。
可选
credits
number
生成视频消耗的积分数。
可选
json
{
"log_id": "as-wn2kax2kbd",
"id": "697c7805d9d1b2f80efe617c",
"status": "success",
"err_code": "",
"creations": [
{
"id": "914750238848192512",
"url": "https://bj.bcebos.com/qianfan-modelbuilder/video/716d42bd78da4a93b56a8af6f61844c6/6888c2ac70964c558230e1901b88fda8/697c7805d9d1b2f80efe617c/video-cq43dk8hell4dc8ki83tko4a.mp4?authorization=bce-auth-v1%2FALTAKEDe5Wum0DnGzeUzScVC94%2F2026-01-30T09%3A27%3A06Z%2F86400%2F%2F31d739cb78e75e78fe7682730a484478c7a924029462ca35e7316f5082c62cf6",
"cover_url": "https://bj.bcebos.com/qianfan-modelbuilder/video/716d42bd78da4a93b56a8af6f61844c6/6888c2ac70964c558230e1901b88fda8/697c7805d9d1b2f80efe617c/image-actek5ghat4w3tokec6uezvi.jpeg?authorization=bce-auth-v1%2FALTAKEDe5Wum0DnGzeUzScVC94%2F2026-01-30T09%3A27%3A06Z%2F86400%2F%2F2307eeb0e065a6012952f9aaf5ba2c0042b9530e42dace0035be2d13d29d052d"
}
],
"usage": {
"model": "VQ2",
"duration": "5",
"resolution": "720p",
"credits": 1.09375
}
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
视频模型通用错误码
| 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 |
评价此篇文章