> ## 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 视频任务列表

> 分页查询最近 7 天内的 MiniMax H3 视频生成和再生成任务。

分页查询当前 API Key 最近 7 天内创建的 MiniMax H3 视频任务，支持按状态、任务 ID 和任务类型过滤。

## 请求示例

```bash theme={null}
curl --request GET \
  --url "https://{your-domain}/v1/videos/generations?page_num=1&page_size=4&filter.model=minimax-h3" \
  --header "Authorization: Bearer $API_KEY"
```

## 查询参数

| 参数                 | 类型        | 必填 | 说明                                                                      |
| ------------------ | --------- | -- | ----------------------------------------------------------------------- |
| `page_num`         | integer   | 否  | 页码，从 1 开始，默认 `1`。                                                       |
| `page_size`        | integer   | 否  | 每页数量，默认 `20`，最大 `100`。                                                  |
| `filter.status`    | string    | 否  | 按任务状态过滤：`queued`、`running`、`succeeded`、`failed`、`cancelled`、`expired`。  |
| `filter.task_ids`  | string\[] | 否  | 按平台任务 ID 过滤，最多 100 个；可重复传入或使用逗号分隔。                                      |
| `filter.model`     | string    | 否  | 传 `minimax-h3` 时仅查询 MiniMax H3 任务；省略时返回当前 API Key 最近 7 天内的全部视频生成和再生成任务。 |
| `filter.task_type` | string    | 否  | 按任务类型过滤：`generation` 或 `regeneration`。                                  |

任务类型说明：

* `generation`：视频生成任务。
* `regeneration`：视频再生成任务。

<Note>
  如果要保证只返回 MiniMax H3 任务，请显式传入 `filter.model=minimax-h3`。实测省略该参数也会返回 `200`，但查询范围会扩大到当前 API Key 可见的其他视频模型任务。
</Note>

## 响应字段

| 字段          | 类型        | 说明                  |
| ----------- | --------- | ------------------- |
| `object`    | string    | 固定为 `list`。         |
| `tasks`     | object\[] | 当前页任务列表。            |
| `page_num`  | integer   | 当前页码。               |
| `page_size` | integer   | 当前每页数量。             |
| `total`     | integer   | 最近 7 天内符合过滤条件的任务总数。 |
| `has_more`  | boolean   | 是否还有下一页。            |

`tasks[]` 中的字段与单任务查询接口一致。每个任务都会返回 `status`、`billing_status` 和 `task_type`；任务成功时可能返回 `content`、`usage`，失败时返回 `error`。

## 响应示例

```json theme={null}
{
  "object": "list",
  "tasks": [
    {
      "id": "vidtask_424635601932571",
      "object": "video.generation.task",
      "created": 1785225940,
      "created_at": 1785225940,
      "updated_at": 1785226100,
      "model": "minimax-h3",
      "task_type": "generation",
      "status": "succeeded",
      "billing_status": "settled",
      "resolution": "2K",
      "duration": 5,
      "ratio": "16:9",
      "content": {
        "video_url": "https://example.com/minimax-h3-output.mp4"
      },
      "usage": {
        "total_seconds": 5,
        "input_seconds": 0,
        "output_seconds": 5,
        "input_image_count": 0
      }
    },
    {
      "id": "vidtask_424635601932588",
      "object": "video.generation.task",
      "created": 1785225900,
      "created_at": 1785225900,
      "updated_at": 1785226080,
      "model": "minimax-h3",
      "task_type": "regeneration",
      "source_task_id": "vidtask_768p_source_example",
      "status": "running",
      "billing_status": "frozen",
      "resolution": "2K",
      "duration": 5,
      "ratio": "16:9"
    },
    {
      "id": "vidtask_424635601932587",
      "object": "video.generation.task",
      "created": 1785225860,
      "created_at": 1785225860,
      "updated_at": 1785225860,
      "model": "minimax-h3",
      "task_type": "generation",
      "status": "queued",
      "billing_status": "frozen",
      "resolution": "768P",
      "duration": 8,
      "ratio": "9:16"
    },
    {
      "id": "vidtask_424635601932586",
      "object": "video.generation.task",
      "created": 1785225800,
      "created_at": 1785225800,
      "updated_at": 1785226020,
      "model": "minimax-h3",
      "task_type": "generation",
      "status": "failed",
      "billing_status": "refunded",
      "resolution": "2K",
      "duration": 12,
      "ratio": "9:16",
      "error": {
        "code": "1026",
        "message": "video description contains sensitive content"
      }
    }
  ],
  "page_num": 1,
  "page_size": 4,
  "total": 476,
  "has_more": true
}
```

## 失败状态

| HTTP 状态码 | 错误类型                   | 场景               |
| -------- | ---------------------- | ---------------- |
| `401`    | `authentication_error` | API Key 缺失或无效。   |
| `429`    | `quota_exceeded`       | 请求受到平台限流。        |
| `500`    | `internal_error`       | 平台内部错误，任务列表查询失败。 |