根据视频任务ID查询视频

功能介绍

根据创建视频生成任务任务ID查询视频生成任务的详细信息和状态。

URI

GET https://api.modelarts-maas.com/v1/video/generations/{task_id}

表1 路径参数
参数	是否必选	参数类型	描述
task_id	是	String	参数解释：创建视频生成任务生成的任务ID。用于查询生成后的视频。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
Authorization	是	String	参数描述： API Key 鉴权凭证，从 MaaS 控制台获取，调用推理API时从请求头 Authorization 字段传入，值格式为：Bearer MaaS_API_Key。

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
task_id	String	参数描述：视频生成后的任务ID。取值范围：不涉及。
status	String	参数描述：视频生成任务状态。取值范围： queued：视频生成任务排队中。 running：视频生成任务运行中。 succeeded：视频生成任务成功。 failed：视频生成任务失败。
error	error object	参数描述：异常信息。
content	content object	参数描述：任务输出信息。
usage	usage object	参数描述：输出信息统计，只对成功的结果计数。
created_at	Long	参数描述：任务创建时间，Unix时间戳，单位毫秒。示例：1750766730771 取值范围：不涉及。
updated_at	Long	参数描述：任务更新时间，Unix时间戳，单位毫秒。示例：1750766738772 取值范围：不涉及。

表4 error
参数	参数类型	描述
code	Integer	错误码。
message	String	错误消息。

表5 content
参数	参数类型	描述
result_url	String	参数描述：生成视频的URL地址。

表6 usage
参数	参数类型	描述
duration	Integer	参数描述：生成视频的总视频时长，用于计费，单位为s。取值范围：不涉及。
size	String	参数描述：生成视频的分辨率。取值范围：不涉及。
audio	String	参数描述：生成视频是否为有声视频。取值范围： true: 有声视频 false: 无声视频
shot_type	String	参数描述：生成视频的镜头类型。取值范围： single: 生成单镜头视频。 multi: 多镜头，系统会进行智能分镜。

请求示例

https://api.modelarts-maas.com/v1/video/generations/{task_id}

响应示例

状态码：200

视频任务详情。

{
  "task_id" : "964395715545571329",
  "status" : "succeeded",
  "error" : {
    "code" : 0,
    "message" : ""
  },
  "content" : {
    "result_url" : "https://example.com/example.mp4"
  },
  "usage" : {
    "duration" : 5,
    "size" : "720*1280",
    "audio" : false,
    "shot_type" : "single"
  },
  "created_at" : 1780281309530,
  "updated_at" : 1780281338634
}