Retrieve a video

Use the task ID returned by the create endpoint to retrieve its status, result, and usage. After the task succeeds, read the video URL from task.content.url.

GET/v2/query/video_generation/{task_id}

Use the Task ID returned by the create endpoint to retrieve the task. A caller can retrieve only tasks it created.

Retrieve the task every 3–5 seconds until its status becomes succeeded, failed, or cancelled. Continue polling while the status is queued or running.

If the MiniMax upstream service returns a valid JSON error, the endpoint preserves its HTTP status code and JSON content.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization Header.

In: header

Path Parameters

task_id*string

Task ID returned when the MiniMax-H3 video was created.

Length1 <= length

Response Body

`application/json`

curl -X GET "https://example.com/v2/query/video_generation/426014652088710"

{
  "task": {
    "id": "426014652088710",
    "model": "MODEL_ID",
    "status": "succeeded",
    "content": {
      "url": "https://example.com/result.mp4"
    },
    "resolution": "2K",
    "duration": 5,
    "ratio": "16:9",
    "task_type": "generation",
    "created_at": 1789625341,
    "updated_at": 1789625437,
    "usage": {
      "input_image_count": 2,
      "input_seconds": 5,
      "input_audio_seconds": 6,
      "output_seconds": 5,
      "total_seconds": 10,
      "prompt_tokens": 480,
      "completion_tokens": 130196,
      "total_tokens": 130676
    }
  }
}

Authorization

Path Parameters

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`