查询视频生成任务状态
更新时间：2026-01-30
GET
https://qianfan.baidubce.com/beta/video/generations/qianfan-video
查询生成视频的任务状态
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
task_id
string
此次视频生成的任务id
可选
model
string
创建当前任务的model
可选
请求结构
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
logid
可选
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
生成视频消耗的积分数
可选
成功响应
{
"log_id": "as-xxx",
"id": "xxx",
"status": "success",
"err_code": "",
"creations": [
{
"id": "xxx",
"url": "xxx",
"cover_url": "xxx"
}
],
"usage": {
"model": "VQ2-Pro",
"duration": "10",
"resolution": "540p",
"credits": 0.03125
}
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
本接口专有错误码如下：
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 400 | BadRequest | bad request | 不合法的请求。 |
| 400 | FieldLacking | field is missing or empty: {{.fields}} | 缺少字段，具体字段见错误信息。 |
| 400 | FieldUnwanted | unwanted field: {{.fields}} | 不需要传某些字段，具体字段见错误信息。 |
| 400 | FieldItemCountOutOfRange | field item count out of range: {{.fields}} | 字段数量超出限制（如数组长度超限）。 |
| 400 | PageSizeOutOfRange | page size out of range | 图像尺寸或格式有问题。 1. 图片大小需小于 50M。 2. 格式只支持 jpg/jpeg/png/webp。 3. 图片长宽比需要小于 1:4 或者 4:1。 4. 跳舞特效的图片长宽比需要在 1:1.2 至 1:2 之间。 |
| 400 | ImageDownloadFailure | image download failure | 下载用户图片URL失败，请检查链接的有效性。 |
| 400 | OperationInProcess | operation in process, please retry later | 请求在处理中，请勿重复提交。 |
| 400 | TaskPromptPolicyViolation | prompt policy violation | Prompt 触发安审风控。 |
| 400 | ImageFormatInvalid | invalid image format | 图像格式不符合要求。 |
| 400 | AuditSubmitIllegal | submit is illegal | 输入内容（图片或文本）没有通过安全审核。 |
| 400 | CreationPolicyViolation | creation policy violation | 生成物触发风控。 |
| 400 | ModelUnavailable | model unavailable | 请求的模型不可用，调用任务失败，请检查模型类型并重试。 |
| 400 | FieldInvalid | invalid field: {{.fields}} | 传入参数未通过合法性校验。 |
| 400 | ImageCheckBodyJointsFailed | Image Check Body Joins Failed | 输入图人体检测失败，请重新上传。 |
| 400 | ImageCheckFaceFailed | Image Check Face Failed | 输入图人脸检测失败，请重新上传。 |
| 400 | ImageObjectsUndetected | Image BodyJoins or Face Too Much Occlusion | 输入图的人体或人脸有遮挡，请重新上传。 |
| 404 | TaskNotFound | task not found | Task id 没找到。 |
| 404 | CreationNotFound | creation not found | Creation id 没找到。 |
| 500 | InternalServiceFailure | internal service failure | 服务器内部错误，请稍后重试，或联系客服。 |
视频模型通用错误码
| 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 |