根据视频任务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
参数	参数类型	描述
prompt_tokens	Integer	参数描述：输入Token数。仅按照Token计费的视频生成模型（通义万相系列模型）系列会返回该参数。取值范围：不涉及。
completion_tokens	Integer	参数描述：输入Token数。仅按照Token计费的视频生成模型（通义万相系列模型）系列会返回该参数。取值范围：不涉及。
total_tokens	Integer	参数描述：输入输出总Token数。仅按照Token计费的视频生成模型（通义万相系列模型）系列会返回该参数。取值范围：不涉及。

请求示例

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

响应示例

状态码：200

视频任务详情。

{
  "task_id" : "cbd1a918b23c7e9bcfac1d428718dca1",
  "status" : "succeeded",
  "error" : {
    "code" : 0,
    "message" : ""
  },
  "content" : {
    "result_url" : "https://example.com/example.mp4"
  },
  "usage" : {
    "prompt_tokens" : 1000,
    "completion_tokens" : 288000,
    "total_tokens" : 288000
  },
  "created_at" : 1780281309530,
  "updated_at" : 1780281338634
}