# 根据视频任务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 
| 参数                | 参数类型    | 描述                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| prompt_tokens     | Integer | **参数解释：** 输入Token数。仅按照Token计费的视频生成模型（通义万相系列模型）系列会返回该参数。 **取值范围：** 不涉及。    |
| completion_tokens | Integer | **参数解释：** 输出Token数。仅按照Token计费的视频生成模型（通义万相系列模型）系列会返回该参数。 **取值范围：** 不涉及。    |
| total_tokens      | Integer | **参数解释：** 输入输出总Token数。仅按照Token计费的视频生成模型（通义万相系列模型）系列会返回该参数。 **取值范围：** 不涉及。 |
| model_latency     | Integer | **参数解释：** 从模型收到请求到返回结果的端到端时延，单位为毫秒。 **取值范围：** 不涉及。                        |
   
#### 请求示例
```
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" : 0,
    "completion_tokens" : 288000,
    "total_tokens" : 288000,
    "model_latency" : 22193
  },
  "created_at" : 1780281309530,
  "updated_at" : 1780281338634
}
```
#### 状态码
| 状态码 | 描述      |
|:---|:---|
| 200 | 视频任务详情。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/model-call-maas/model-call-035.html)。