查询视频生成任务
更新时间：2026-11-11
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 参数
除公共头域外，无其它特殊头域
返回参数
log_id
string
本次请求日志 ID
可选
id
string
视频生成任务 ID（即 task_id）
可选
status
string
任务状态。可选值：created（排队/刚提交）、processing（运行中）、success（成功）、failed（失败，可结合 err_code 判断）
可选
err_code
string
错误码，任务失败时返回，成功时为空串
可选
usage
object {3}
用量信息
可选
显示子属性
隐藏子属性
duration
string
生成视频时长（秒）
可选
resolution
string
生成视频分辨率
可选
total_tokens
integer
本次消耗的总 token 数
可选
result
object {11}
任务结果信息
可选
显示子属性
隐藏子属性
model
string
实际使用的模型 ID
可选
content
object {2}
输出内容
可选
显示子属性
隐藏子属性
video_url
string
生成视频的 URL（有效期约 24h，请及时转存）
可选
last_frame_url
string
尾帧图像 URL；创建任务时 return_last_frame 为 true 时返回
可选
seed
integer
本次使用的随机种子
可选
resolution
string
生成视频分辨率
可选
ratio
string
生成视频宽高比
可选
duration
integer
生成视频时长（秒）
可选
framespersecond
integer
生成视频帧率
可选
execution_expires_after
integer
任务超时阈值（秒）
可选
generate_audio
boolean
是否包含与画面同步的音频
可选
output_format
string
封装格式（mp4 / mov）
可选
tools
array
本次实际使用的工具，未使用时为 null
可选
显示子属性
隐藏子属性
items
object {1}
显示子属性
隐藏子属性
type
string
使用的工具类型
可选
created_at
integer
任务创建时间（Unix 时间戳，单位：毫秒）
可选
updated_at
integer
任务当前状态更新时间（Unix 时间戳，单位：毫秒）
可选
响应示例
{
"log_id": "as-zew3q21234",
"id": "6aab8ff436d05f09fb312345",
"status": "success",
"err_code": "",
"usage": {
"duration": "4",
"resolution": "480p",
"total_tokens": 40594
},
"result": {
"model": "S2.0-Mini",
"content": {
"video_url": "xxxxxxxxxxxx",
"last_frame_url": "xxxxxxxxxxxx"
},
"seed": 12345,
"resolution": "480p",
"ratio": "1:1",
"duration": 4,
"framespersecond": 24,
"execution_expires_after": 172800,
"generate_audio": false,
"output_format": "mp4",
"tools": null
},
"created_at": 1789628404123,
"updated_at": 1789628650123
}
评价此篇文章