MIminimax
Video V2

List tasks

List tasks from the last 7 days with pagination. Supports filtering by status, task ID, model, and task type.

get/v2/query/video_generation

Request

Query parameters

page_numinteger
Example:1

Page number, starting from 1.

page_sizeinteger
Example:20

Number of items per page.

filter.status'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled'

Filter by task status. Available values: queued, running, succeeded, failed, cancelled.

filter.task_idsstring[]

Filter by task ID; multiple values are allowed.

filter.modelstring

Filter by model name, e.g. MiniMax-H3.

filter.task_type'generation' | 'h3_context_ir' | 'regeneration'

Filter by task type. Available values: generation (video generation), h3_context_ir (H3-Context-IR), regeneration (video regeneration).

Response

totalinteger

Total number of tasks matching the filter (counting only tasks from the last 7 days).

Example response

{
  "items": [
    {
      "id": "424635601932571",
      "model": "MiniMax-H3",
      "status": "succeeded",
      "created_at": 1785225940,
      "updated_at": 1785226100,
      "content": {
        "url": "https://video-product.cdn.minimax.io/inference_output/rollout/2026-07-28/5fe7ec4a-6f51-4d69-880e-220e59535d98/output.mp4"
      },
      "resolution": "2K",
      "duration": 5,
      "usage": {
        "total_seconds": 5,
        "input_seconds": 0,
        "output_seconds": 5,
        "input_image_count": 1,
        "input_audio_seconds": 6,
        "total_tokens": 273890,
        "prompt_tokens": 13500,
        "completion_tokens": 260390
      },
      "ratio": "adaptive",
      "task_type": "generation"
    },
    {
      "id": "424635601932588",
      "model": "MiniMax-H3",
      "status": "running",
      "created_at": 1785225940,
      "updated_at": 1785226100,
      "resolution": "2K",
      "duration": 10,
      "usage": {},
      "ratio": "9:16",
      "task_type": "generation"
    },
    {
      "id": "424635601932587",
      "model": "MiniMax-H3",
      "status": "queued",
      "created_at": 1785225940,
      "updated_at": 1785226100,
      "resolution": "2K",
      "duration": 8,
      "usage": {},
      "ratio": "9:16",
      "task_type": "generation"
    },
    {
      "id": "424635601932586",
      "model": "MiniMax-H3",
      "status": "failed",
      "created_at": 1785225940,
      "updated_at": 1785226100,
      "error": {
        "code": "1026",
        "message": "video description contains sensitive content"
      },
      "resolution": "2K",
      "duration": 12,
      "usage": {},
      "ratio": "9:16",
      "task_type": "generation"
    }
  ],
  "total": 476
}

Changes

No recorded changes to this operation across all 1 revision of this API.