Query Task

Use `GET /v1/video/query` to query MiniMax unified video task status and results.

GEThttps://zx1.deepwl.net/v1/video/query

Request

curl "https://zx1.deepwl.net/v1/video/query?id=task_a1b2c3d4e5f6" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "id": "task_a1b2c3d4e5f6",
  "object": "video",
  "model": "MiniMax-H3",
  "status": "completed",
  "progress": 100,
  "created_at": 1785125529,
  "completed_at": 1785125946,
  "seconds": "5",
  "size": "2K",
  "video_url": "https://cdn.example.com/h3-generated-2k-output.mp4",
  "metadata": {
    "url": "https://cdn.example.com/h3-generated-2k-output.mp4",
    "ratio": "16:9"
  }
}

After submitting a MiniMax unified video task, query progress and results via GET /v1/video/query. Note that the query parameter for this route is id, not task_id.

Once the task succeeds (status=completed), the asset URL is available in the video_url field.

Status transitions

status	Meaning	progress
`queued`	Queued	10
`in_progress`	Generating	50
`completed`	Succeeded	100
`failed`	Failed or cancelled	100

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

Request Headers

Authorizationstring必填

Authentication header. Uses a Bearer token, e.g. Bearer YOUR_API_KEY.

Request Parameters

idstring必填

Task ID, identical to the id returned by Create Video.

Request Example

Response Example

Response fields are identical to the OpenAI format query API; see the response fields in MiniMax Task Query.

Error Codes

Status Code	Description
400	Task not found or beyond the 7-day query window
401	Authentication failed
500	Internal server error