# 根据视频任务ID查询视频
#### 功能介绍
根据**创建视频生成任务**接口生成任务ID查询视频生成任务的详细信息和状态。
**任务数据（如任务状态、视频URL等）仅保留24小时，超时后会被自动清除。请您务必及时保存生成的视频。**
#### 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 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   
 表4error 
| 参数      | 参数类型    | 描述    |
|:---|:---|:---|
| code    | Integer | 错误码。  |
| message | String  | 错误消息。 |
   
 表5content 
| 参数         | 参数类型   | 描述                                                                                                                              |
|:---|:---|:---|
| result_url | String | **参数描述：** 生成视频的URL地址。 |
   
 表6usage 
| 参数        | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|
| duration  | Integer | **参数描述：** 生成视频的总视频时长，用于计费，单位为s。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| size      | String  | **参数描述：** 生成视频的分辨率。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| audio     | String  | **参数描述：** 生成视频是否为有声视频。 **取值范围：** - true: 有声视频   - false: 无声视频                  |
| shot_type | String  | **参数描述：** 生成视频的镜头类型。 **取值范围：** - single: 生成单镜头视频。   - multi: 多镜头，系统会进行智能分镜。    |
   
#### 请求示例
```
https://api.modelarts-maas.com/v1/video/generations/964395715545571329
```
#### 响应示例
**状态码：200**
视频任务详情。
```
{
  "task_id" : "964395715545571329",
  "status" : "succeeded",
  "error" : {
    "code" : 0,
    "message" : ""
  },
  "content" : {
    "result_url" : "https://example.com/example.mp4"
  },
  "usage" : {
    "duration" : 5,
    "size" : "1280*720",
    "audio" : false,
    "shot_type" : "single"
  },
  "created_at" : 1780281309530,
  "updated_at" : 1780281338634
}
```
#### 状态码
| 状态码 | 描述      |
|:---|:---|
| 200 | 视频任务详情。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/model-call-maas/model-call-035.html)。