curl "https://zx1.deepwl.net/v1/video/query?id=task_a1b2xxxxx5f6" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"id": "task_a1b2xxxxx5f6",
"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"
}
}
{
"code": "task_not_exist",
"message": "task_not_exist",
"data": null
}
Unified Video
MiniMax-H3 Query Task (Unified Format)
Query a MiniMax-H3 video task status and result with GET /v1/video/query?id=.
GET
https://zx1.deepwl.net
/
v1
/
video
/
query
curl "https://zx1.deepwl.net/v1/video/query?id=task_a1b2xxxxx5f6" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"id": "task_a1b2xxxxx5f6",
"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"
}
}
{
"code": "task_not_exist",
"message": "task_not_exist",
"data": null
}
MiniMax-H3 Query Task (Unified Format)
Retrieves the status of a video generation or 2K regeneration task via theid query parameter. Once the task completes, the time-limited download URL is in the video_url field. The status flow, response fields, and polling guidance are identical to OpenAI-format Task Query.
Method and Path
GET /v1/video/query?id={task_id}
curl "https://zx1.deepwl.net/v1/video/query?id=task_a1b2xxxxx5f6" \
-H "Authorization: Bearer YOUR_API_KEY"
Query Parameters
string
required
The task
id returned by the create endpoint. Note the parameter name on this route is id, not task_id.Response Example
{
"id": "task_a1b2xxxxx5f6",
"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"
}
}
{
"code": "task_not_exist",
"message": "task_not_exist",
"data": null
}
Error Codes
| HTTP Status | Description |
|---|---|
400 | Task does not exist or is outside the 7-day query window |
401 | Authentication failed |
500 | Server error |