MiniMax-H3 Query Video Generation Task

Queries the status and result of a video generation, H3-Context-IR, or video regeneration task by task_id (within the last 7 days).

Endpoint

GET /minimax/v2/query/video_generation/{task_id}

Request Headers

Parameter	Type	Required	Description
Authorization	string	Yes	Authentication, format Bearer <API_KEY>

Path Parameters

Parameter	Type	Required	Description
task_id	string	Yes	The task ID to query (returned when creating the task)

Request Example

curl --request GET \
  --url https://neolink.com/api/minimax/v2/query/video_generation/{task_id} \
  --header 'Authorization: Bearer <API_KEY>'

Success Response (HTTP 200)

{
  "task": {
    "id": "424010985738629",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1785125529,
    "updated_at": 1785125946,
    "content": {
      "url": "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/89f8c0bbee5b_denoise_ids_0_final.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",
    "modality": "video"
  }
}

Field	Type	Description
task.id	string	Task ID
task.model	string	Model used
task.status	string	Task status: queued, running, succeeded, failed, cancelled
task.created_at	integer	Creation time, Unix timestamp (seconds)
task.updated_at	integer	Last update time, Unix timestamp (seconds)
task.content.url	string	Generated video download URL
task.content.prompt	string	Enhanced prompt returned by H3-Context-IR task
task.resolution	string	Video resolution
task.duration	integer	Video duration (seconds)
task.ratio	string	Video aspect ratio
task.task_type	string	Task type: generation, regeneration, h3_context_ir
task.modality	string	Output modality: video, text
task.usage	object	Usage statistics

usage Object

Field	Type	Description
total_seconds	integer	Total seconds
input_seconds	integer	Input video seconds
output_seconds	integer	Output video seconds
input_image_count	integer	Number of input images
input_audio_seconds	integer	Input audio seconds
total_tokens	integer	Total tokens consumed
prompt_tokens	integer	Prompt tokens
completion_tokens	integer	Completion tokens

Python Example

import requests

url = "https://neolink.com/api/minimax/v2/query/video_generation/{task_id}"
headers = {"Authorization": "Bearer <API_KEY>"}

response = requests.get(url, headers=headers)
print(response.text)

错误响应

HTTP 状态码	错误类型	错误码	说明
400	bad_request_error	2013	参数无效，content 必须包含非空 text 项
401	authorized_error	1004	认证失败
402	insufficient_balance_error	1008	余额不足
422	unprocessable_entity_error	1026	视频描述包含敏感内容
429	rate_limit_error	1002	速率限制，请稍后重试
500	server_error	1000	内部错误