查询视频生成任务
本接口根据任务 ID 查询单个异步任务的状态、产物和用量信息。
创建视频生成任务、创建提示词优化任务和创建视频再生成任务均通过本接口查询，可由响应中的 task_type 字段区分任务类型。
任务记录仅保留最近 7 天，超出该时间范围的任务无法查询。
权限说明
调用本 API，需使用 API Key 鉴权。具体流程请参见认证鉴权。
请求参数
需要查询的任务 ID，由创建任务接口返回。
GET /beta/video/generations/qianfan-video/m-series?task_id={task_id} HTTP/1.1
Host: qianfan.baidubce.com
Authorization: Bearer <API_KEY>示例代码
curl --get 'https://qianfan.baidubce.com/beta/video/generations/qianfan-video/m-series' \
--header 'Authorization: Bearer <API_KEY>' \
--data-urlencode 'task_id=6a7b2b4c20e153ebae376f38'返回响应
本次请求的唯一标识，可用于问题排查与追溯。
本次查询请求的处理结果。success：查询成功。
该字段表示查询请求本身是否成功，与被查询任务的状态无关，任务状态请取 task.status。
任务的详细信息。
显示子属性
隐藏子属性
任务 ID。
任务使用的模型名称。
任务状态。queued：排队中。running：运行中。succeeded：已成功。failed：已失败。cancelled：已取消。
错误信息，仅当任务状态为 failed 时返回。
显示子属性
隐藏子属性
错误码。
错误描述信息。
任务创建时间，Unix 时间戳，单位：秒。
任务状态最近一次更新时间，Unix 时间戳，单位：秒。
任务输出内容，仅当任务状态为 succeeded 时返回。
显示子属性
隐藏子属性
生成视频的访问 URL，仅当任务类型为 generation 或 regeneration 时返回。
该 URL 为带签名的临时地址，Expires 参数标识过期时间，请在有效期内下载或转存到自有存储。
任务产物的分辨率。
任务产物的时长，单位：秒。
本次任务的用量信息，用于计费核对。
视频生成和视频再生成任务返回秒数与图片数量字段；提示词优化任务返回 Token 字段。
显示子属性
隐藏子属性
本次计费的总秒数，等于 input_seconds 与 output_seconds 之和。
输入参考视频的计费秒数，仅当输入包含参考视频时计费。
输出视频的计费秒数。
本次计费涉及的输入图片数量。
提示词优化（h3_context_ir）任务消耗的 Token 总数。
提示词优化（h3_context_ir）任务的输入 Token 数。
提示词优化（h3_context_ir）任务的输出 Token 数。
任务产物的宽高比。当前任务类型不适用时返回空字符串。
任务类型。generation：视频生成。h3_context_ir：提示词优化。regeneration：视频再生成。
任务产物的模态。video：视频，视频生成和视频再生成任务返回该值。text：文本，提示词优化任务返回该值。
{
"log_id": "as-gr04iga5sh",
"status": "success",
"task": {
"id": "6a7b2b4c20e153ebae376f38",
"model": "qianfan-video-v4",
"status": "succeeded",
"created_at": 1786458112,
"updated_at": 1786458788,
"content": {
"url": "https://example.invalid/videos/output_aigc.mp4?Expires=1786545193&Signature=<SIGNATURE>"
},
"usage": {
"total_seconds": 20,
"input_seconds": 10,
"output_seconds": 10,
"input_image_count": 1
},
"resolution": "2K",
"duration": 10,
"ratio": "16:9",
"task_type": "generation",
"modality": "video"
}
}评价此篇文章