Skip to main content
GET

MiniMax-H3 Task Query

Query a video generation or 2K regeneration task by task ID. Once the task completes, the time-limited download URL is in the video_url field.

Method and Path

Path Parameters

string
required
The task id returned by the create endpoint.

Status Flow

Poll every 5–10 seconds. The upstream retains task records for only the last 7 days; video download links are time-limited, so download or persist them promptly.

Response Example

Response

string
Task ID.
string
Legacy task ID, may be returned; same value as id.
string
Object type, always video.
string
Model name used by the task.
string
Task status: queued, in_progress, completed, or failed.
integer
Task progress percentage.
integer
Task creation time, Unix timestamp (seconds).
integer
Task completion time, Unix timestamp (seconds).
integer
Result expiration time, Unix timestamp (seconds).
string
Output duration (seconds), as a string.
string
Output resolution.
string
Time-limited download URL of the video output.
object
Extra information. On success, contains url and the actual aspect ratio ratio.
object
Failure reason, containing code and message.

Error Codes