MiniMax H3 · MiniMax 格式

查询视频生成任务列表

查询最近 7 天的任务，可以按状态、任务 ID 或模型筛选，分页返回。请求参数和返回结果与 MiniMax「查询视频生成任务列表」（视频生成 V2）接口一致。

GEThttps://your-domain/minimax/v2/query/video_generation

请求示例

curl "https://your-domain/minimax/v2/query/video_generation?page_num=1&page_size=10&filter.status=succeeded" \
  -H "Authorization: Bearer $MINIMAX_API_KEY"

返回结果

{
  "items": [
    {
      "id": "video_8f3k2m9x4q1w7e5r0t6y2u4p",
      "model": "MiniMax-H3",
      "status": "succeeded",
      "created_at": 1791691200,
      "updated_at": 1791691352,
      "content": {
        "url": "https://your-domain/uploads/videos/2026/10/k3Zq8mVt2LxR9pWa.mp4"
      },
      "resolution": "768P",
      "duration": 6,
      "usage": {
        "input_image_count": 0,
        "input_seconds": 0,
        "output_seconds": 6,
        "total_seconds": 6
      },
      "ratio": "16:9",
      "task_type": "generation",
      "modality": "video"
    }
  ],
  "total": 1
}

请求参数

参数都放在查询字符串里，都可以不传。

查询参数

page_numinteger默认值 1

页码，1 到 100000。

page_sizeinteger默认值 20

每页的任务数，1 到 100。

filter.statusstring

按任务状态筛选：queued、running、succeeded、failed 或 cancelled，含义见任务状态。

filter.task_idsstring[]

按任务 ID 精确查询。查询多个任务时重复这个参数，例如 filter.task_ids=id1&filter.task_ids=id2，也可以在一个参数里用英文逗号分隔多个 ID。

filter.modelstring

按模型 ID 筛选，例如 MiniMax-H3，不区分大小写。

filter.task_typestring

按任务类型筛选。平台只有 generation（视频生成）任务，传 h3_context_ir 或 regeneration 时返回空列表。

返回参数

itemsobject[]

当前页的任务，按创建时间从新到旧排列。每个任务的字段和查询视频生成任务返回的 task 相同。

totalinteger

符合筛选条件的任务总数。

和 MiniMax 一样，只能查到最近 7 天创建的任务。更早的任务可以用任务 ID 单独查询，或者在控制台 → 视频任务里查看。
列表只包含 MiniMax 模型的任务，用 OpenAI 格式或在控制台创建的 MiniMax 任务也在其中。
创建时返回错误的请求不会生成任务，也不在列表里。

请求示例

按任务 ID 批量查询

重复传 filter.task_ids，一次查询多个任务：

按任务 ID 批量查询

curl "https://your-domain/minimax/v2/query/video_generation?filter.task_ids=video_8f3k2m9x4q1w7e5r0t6y2u4p&filter.task_ids=video_2b7n5c1v9z3x6m8q4w0e1r7t" \
  -H "Authorization: Bearer $MINIMAX_API_KEY"