> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wengaocloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询 MiniMax H3 视频任务

> 查询 MiniMax H3 异步视频任务的状态、生成结果和计费用量。

使用创建响应中的任务 ID 查询 MiniMax H3 视频任务。

```
GET /v1/videos/generations/{id}
```

`id` 为 [创建 MiniMax H3 视频任务](/guides/minimax-h3-create-task) 返回的任务 ID，格式通常以 `vidtask_` 开头。

<Note>
  创建和查询响应中的 `model` 字段均使用公开模型 ID `minimax-h3`。
</Note>

## 查询示例

建议每 5–10 秒查询一次，不要高频轮询。2K 或 15 秒任务可能需要数分钟。

```bash theme={null}
curl "https://{your-domain}/v1/videos/generations/vidtask_c22b8c06d0524a64a85ef3632fd7015e" \
  -H "Authorization: Bearer $API_KEY"
```

## 任务状态

| `status`    | 说明        | 下一步操作                      |
| ----------- | --------- | -------------------------- |
| `queued`    | 排队中，等待处理。 | 继续轮询                       |
| `running`   | 视频正在生成中。  | 继续轮询                       |
| `succeeded` | 任务成功。     | 读取 `content.video_url` 并下载 |
| `failed`    | 任务失败。     | 查看 `error` 字段排查原因          |
| `cancelled` | 任务已取消。    | 无需继续查询                     |
| `expired`   | 任务超过执行期限。 | 重新提交任务                     |

## 成功响应

```json theme={null}
{
  "id": "vidtask_c22b8c06d0524a64a85ef3632fd7015e",
  "object": "video.generation.task",
  "created": 1785987048,
  "created_at": 1785987050,
  "updated_at": 1785987635,
  "model": "minimax-h3",
  "status": "succeeded",
  "billing_status": "settled",
  "resolution": "2K",
  "ratio": "16:9",
  "duration": 15,
  "content": {
    "video_url": "https://example.com/minimax-h3-output.mp4"
  },
  "usage": {
    "output_seconds": 15,
    "input_seconds": 0,
    "input_image_count": 0,
    "total_seconds": 15
  }
}
```

<Note>
  单次下载链接有效期是 24 小时；7 天内可重新查询获取新链接。
</Note>

## usage 用量字段

| `usage` 字段          | 说明           |
| ------------------- | ------------ |
| `output_seconds`    | 实际输出视频秒数。    |
| `input_seconds`     | 实际读取的参考视频秒数。 |
| `input_image_count` | 实际使用的输入图片数量。 |
| `total_seconds`     | 任务统计的总秒数。    |

<Warning>
  `content.video_url` 是有有效期的签名地址。任务成功后请及时下载并转存到自己的存储。
</Warning>

## 计费与账务状态

* 输出视频按实际 `output_seconds` 结算。
* 使用参考视频时，可能额外按实际 `input_seconds` 结算。
* 输入图片是否额外计费，取决于当前价格配置中的免费张数。
* `768P` 与 `2K` 使用不同单价，最终价格以控制台模型广场和账单为准。

任务创建后先冻结预估费用。任务失败、取消或超时，账务状态通常会变为 `refunded`；成功后变为 `settled`。

<Note>
  再生成任务的 `ratio` 由上游结果决定，实测在查询阶段可能返回空字符串；`base_video` 模式在任务尚未完成时 `duration` 也可能暂时为 `0`。请以 `status=succeeded` 后的实际字段和 `usage` 为准。
</Note>