查询 MiniMax H3 视频任务列表 - 问高云API开发文档

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

请求示例

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：视频再生成任务。

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

响应字段

字段	类型	说明
`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。

响应示例

{
  "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`	平台内部错误，任务列表查询失败。