Query Task

Version: v1.0.0 | Last Updated: 2026-08-13
This platform fully supports the MiniMax Video Generation V2 (MiniMax-H3) official API. Requests and responses are transparently proxied, and all parameter semantics remain consistent with the official API.

Queries the status and result of a single video generation, video regeneration, or H3-Context-IR task by task_id. Once the task succeeds (status=succeeded), the output is available in content: video tasks return content.url, and H3-Context-IR tasks return content.prompt.

GET https://platform.dataeyes.ai/hailuo/v2/query/video_generation/{task_id}

Path Parameters

Parameter	Type	Required	Description
`task_id`	string	Yes	The task ID returned when the task was created

Status synchronization may lag briefly right after submission; the query result may then contain only the task ID. Retry shortly to get the full status.
Video download URLs are time-limited — download or persist promptly; if a URL expires, query again for a fresh one. We recommend querying and persisting outputs within 7 days of task completion.

Request Example

Response Examples

Successful video generation:

{
  "task": {
    "id": "424010985738629",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1785125529,
    "updated_at": 1785125946,
    "content": {
      "url": "https://cdn.example.com/h3-generated-2k-output.mp4"
    },
    "resolution": "2K",
    "duration": 5,
    "usage": {
      "total_seconds": 5,
      "input_seconds": 0,
      "output_seconds": 5,
      "input_image_count": 0
    },
    "ratio": "16:9",
    "task_type": "generation",
    "modality": "video"
  }
}

Failed task:

{
  "task": {
    "id": "424010985738630",
    "model": "MiniMax-H3",
    "status": "failed",
    "error": {
      "code": "1026",
      "message": "video description contains sensitive content"
    },
    "created_at": 1785125529,
    "updated_at": 1785125700,
    "resolution": "2K",
    "duration": 5,
    "usage": {
      "total_seconds": 0,
      "input_seconds": 0,
      "output_seconds": 0,
      "input_image_count": 0
    },
    "ratio": "16:9",
    "task_type": "generation",
    "modality": "video"
  }
}

Response Fields (task object)

Field	Type	Description
`id`	string	Task ID
`model`	string	Model used by the task, e.g. `MiniMax-H3`
`status`	string (enum)	Task status: `queued` / `running` / `succeeded` / `failed` / `cancelled`
`error`	object	Error info, returned only for failed tasks: `code` and `message`
`created_at`	integer	Task creation time, Unix timestamp (seconds)
`updated_at`	integer	Last status update time, Unix timestamp (seconds)
`content`	object	Task output, returned after the task succeeds (see below)
`resolution`	string	Output resolution
`duration`	integer	Output duration in seconds
`usage`	object	Billing usage (see below)
`ratio`	string	Output aspect ratio; may be an empty string when not applicable to the task type
`task_type`	string (enum)	Task type: `generation` / `regeneration` / `h3_context_ir`
`modality`	string (enum)	Output modality: `video` for generation / regeneration; `text` for H3-Context-IR

content fields:

Field	Type	Description
`url`	string	Time-limited download URL of the video output (video tasks)
`prompt`	string	Structured enhanced prompt (only when `task_type=h3_context_ir` and the task succeeded)

usage fields (billing basis):

Field	Type	Applies to	Description
`total_seconds`	integer	Video tasks	Total billed seconds = input seconds + output seconds
`input_seconds`	integer	Video tasks	Billed seconds of input reference video
`output_seconds`	integer	Video tasks	Billed seconds of output video
`input_image_count`	integer	Video tasks	Number of input images counted for billing
`total_tokens`	integer	Context-IR	Total tokens
`prompt_tokens`	integer	Context-IR	Input tokens
`completion_tokens`	integer	Context-IR	Output tokens

04-Query-Task

Query Task#

Path Parameters#

Request Example#

Response Examples#

Response Fields (task object)#

Query Task

Path Parameters

Request Example

Response Examples

Response Fields (task object)