curl https://zx1.deepwl.net/v1/videos/task_a1b2xxxxx5f6 \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
resp = requests.get(
"https://zx1.deepwl.net/v1/videos/task_a1b2xxxxx5f6",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(resp.json())
const response = await fetch(
"https://zx1.deepwl.net/v1/videos/task_a1b2xxxxx5f6",
{ headers: { Authorization: "Bearer YOUR_API_KEY" } },
);
console.log(await response.json());
{
"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
}
OpenAI Format
MiniMax-H3 Task Query
Query a MiniMax-H3 video task status and result with GET /v1/videos/{task_id}.
GET
https://zx1.deepwl.net
/
v1
/
videos
/
{task_id}
curl https://zx1.deepwl.net/v1/videos/task_a1b2xxxxx5f6 \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
resp = requests.get(
"https://zx1.deepwl.net/v1/videos/task_a1b2xxxxx5f6",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(resp.json())
const response = await fetch(
"https://zx1.deepwl.net/v1/videos/task_a1b2xxxxx5f6",
{ headers: { Authorization: "Bearer YOUR_API_KEY" } },
);
console.log(await response.json());
{
"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 Task Query
Query a video generation or 2K regeneration task by task ID. Once the task completes, the time-limited download URL is in thevideo_url field.
Method and Path
GET /v1/videos/{task_id}
curl https://zx1.deepwl.net/v1/videos/task_a1b2xxxxx5f6 \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
resp = requests.get(
"https://zx1.deepwl.net/v1/videos/task_a1b2xxxxx5f6",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(resp.json())
const response = await fetch(
"https://zx1.deepwl.net/v1/videos/task_a1b2xxxxx5f6",
{ headers: { Authorization: "Bearer YOUR_API_KEY" } },
);
console.log(await response.json());
Path Parameters
string
required
The task
id returned by the create endpoint.Status Flow
status | Meaning | Typical progress |
|---|---|---|
queued | Queued | 10 |
in_progress | Generating | 50 |
completed | Succeeded | 100 |
failed | Failed or canceled | 100 |
Poll every 5–10 seconds. The upstream retains task records for only the last 7 days; video download links are time-limited, so download or persist them promptly.
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
}
Response
string
Task ID.
string
Legacy task ID, may be returned; same value as
id.string
Object type, always
video.string
Model name used by the task.
string
Task status:
queued, in_progress, completed, or failed.integer
Task progress percentage.
integer
Task creation time, Unix timestamp (seconds).
integer
Task completion time, Unix timestamp (seconds).
integer
Result expiration time, Unix timestamp (seconds).
string
Output duration (seconds), as a string.
string
Output resolution.
string
Time-limited download URL of the video output.
object
Extra information. On success, contains
url and the actual aspect ratio ratio.object
Failure reason, containing
code and message.Error Codes
| HTTP Status | Description |
|---|---|
400 | Task does not exist or is outside the 7-day query window |
401 | Authentication failed |
500 | Server error |