# 根据视频任务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。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| resolution | String  | **参数描述：** 视频分辨率档位。 **约束限制：** 仅爱诗系列模型返回该字段。 **取值范围：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| audio      | String  | **参数描述：** 生成视频是否为有声视频。 **取值范围：** - true: 有声视频   - false: 无声视频    |
   
#### 请求示例
```
https://api.modelarts-maas.com/v1/video/generations/408914860220871
```
#### 响应示例
**状态码：200**
视频任务详情。
```
{
    "task_id": "408914860220871",
    "status": "succeeded",
    "error": {
        "code": 0,
        "message": ""
    },
    "content": {
        "result_url": "https://example.com/example.mp4"
    },
    "usage": {
        "duration": 5,
        "audio": false,
        "resolution": "720p"
    },
    "created_at": 1781787813000,
    "updated_at": 1781787832000
}
```
#### 状态码
| 状态码 | 描述      |
|:---|:---|
| 200 | 视频任务详情。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/model-call-maas/model-call-035.html)。