MIminimax
Video V2

Query Task

Query the status and result of a single video generation, H3-Context-IR, or video regeneration task. Once the task succeeds (status=succeeded), retrieve video output from content.url or an enhanced prompt from content.prompt.

Only tasks from the last 7 days can be queried (window [T-7d, T), where T is the request time as a UTC timestamp in seconds); a task_id outside this window returns invalid task_id. Video output URLs are time-limited, so download or store them promptly.

get/v2/query/video_generation/{task_id}

Request

Path parameters

task_idstring required

ID of the task to query (the task_id returned when the task was created).

Response

Example response

{
  "task": {
    "id": "424010985738629",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1785125529,
    "updated_at": 1785125946,
    "content": {
      "url": "https://video-product.cdn.minimax.io/inference_output/rollout/2026-07-27/6c68f487-4b33-48cb-8c92-1631f63f6682/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": "16:9",
    "task_type": "generation"
  }
}

Changes

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