查询视频生成任务
更新时间：2026-07-24
GET
https://qianfan.baidubce.com/beta/video/generations/qianfan-video/fireseries
本接口根据创建任务时返回的 task_id 获取视频生成任务的状态和结果信息，任务成功后返回生成视频的 URL。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
task_id
string
需要查询的视频生成任务的 ID，即创建视频生成任务接口返回的 id
必选
请求结构
GET /beta/video/generations/qianfan-video/fireseries?task_id=<task_id> HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json示例代码
请求示例
curl -X GET "https://qianfan.baidubce.com/beta/video/generations/qianfan-video/fireseries?task_id=6a4f0********ba489" \
-H "Authorization: Bearer bce-v3/ALTAK-*************eb1c5e9ddc8cf3edf18ef6d03f1517ec9408"返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
id
string
视频生成任务的 ID（task_id）
可选
model
string
本次任务使用的模型名称
可选
status
string
任务状态，以及相关的信息。可选值：queued：排队中running：运行中cancelled：取消任务succeeded：任务成功failed：任务失败expired：任务超时
可选
error
object {2}
错误信息对象，任务失败时返回
可选
显示子属性
隐藏子属性
code
string
错误码
可选
message
string
错误信息
可选
content
object {2}
视频生成任务结果，任务完成后包含生成结果信息
可选
显示子属性
隐藏子属性
video_url
string
生成视频的 URL
可选
last_frame_url
string
视频的尾帧图像 URL，创建任务时 return_last_frame 为 true 时返回
可选
usage
object {2}
Token 使用统计信息
可选
显示子属性
隐藏子属性
total_tokens
integer
总消耗的 token 数
可选
completion_tokens
integer
补全消耗的 token 数
可选
resolution
string
生成视频的分辨率
可选
ratio
string
生成视频的宽高比
可选
duration
integer
生成视频的时长，单位：秒
可选
generate_audio
boolean
生成的视频是否包含与画面同步的声音true：包含同步音频false：无声视频
可选
created_at
integer
任务创建时间（Unix 时间戳，单位：秒）
可选
updated_at
integer
任务当前状态更新时间（Unix 时间戳，单位：秒）
可选
响应示例
{
"id": "6a4f06890b1f00cb2a8ba489",
"model": "S2.0",
"status": "succeeded",
"content": {
"video_url": "https://bj.bcebos.com/qianfan-modelbuilder/video/716d42bd78da4a93b56a8af6f61844c6/6888c2ac70964c558230e1901b88fda8/698ad93f56f70ee357a845a1/video-ptkmhcbbzpxpbmkxdklt1hem.mp4?xxx"
},
"usage": {
"completion_tokens": 45000,
"total_tokens": 45120
},
"created_at": 1753093800,
"updated_at": 1753093920,
"resolution": "720p",
"ratio": "16:9",
"duration": 5,
"generate_audio": true
}评价此篇文章