MiniMax task query

After submitting a MiniMax task, query generation or remix task status and results by task ID.

GET /v1/videos/{task_id}

Replace {task_id} in the path with the task ID returned by Video generation. When the task succeeds (status=completed), the output URL is in the video_url field.

Headers

Name	Type	Required	Description
	string	Yes	Request authentication. Use a Bearer Token, for example:

Request parameters

Name	Type	Required	Description
	string	Yes	Path parameter. Same as the id returned by the generation endpoint

Status flow

status	Meaning	progress
	Queued	10
	Generating	50
	Succeeded	100
	Failed or cancelled	100

Recommended polling interval: 5–10 seconds. Upstream retains only the last 7 days of task records; task IDs outside that window will fail to query. Video download links expire; download or persist them promptly.

Request example

curl https://octopusx.ai/v1/videos/task_a1bxxxxxe5f6 \
  -H "Authorization: Bearer <token>"

Response example

Completed

{
  "id": "task_a1bxxxxxe5f6",
  "task_id": "task_a1bxxxxxe5f6",
  "object": "video",
  "model": "MiniMax-H3",
  "status": "completed",
  "progress": 100,
  "created_at": 1785125529,
  "video_url": "https://example.com/video.mp4"
}

Failed

{
  "id": "task_a1bxxxxxe5f6",
  "task_id": "task_a1bxxxxxe5f6",
  "object": "video",
  "model": "MiniMax-H3",
  "status": "failed",
  "progress": 100,
  "created_at": 1785125529,
  "error": {
    "message": "request failed",
    "code": "upstream_error"
  }
}

Response fields

Name	Type	Description
	string	Task ID
	string	Legacy-compatible task ID (to be deprecated; same value as )
	string	Always
	string	Model name used by the task
	string	See the status table above
	integer	Progress percentage
	string	Output URL after the task succeeds
	object	Failure reason (includes / )

Related endpoints

• Video APIs overview
• MiniMax video generation
• Error codes