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 格式
MiniMax-H3 任务查询
使用 GET /v1/videos/{task_id} 查询 MiniMax-H3 视频任务状态与结果。
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 任务查询
通过任务 ID 查询视频生成或 2K 再生成任务。任务完成后,视频限时下载地址位于video_url 字段。
方法与路径
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
必填
创建接口返回的任务
id。状态流转
status | 含义 | 典型 progress |
|---|---|---|
queued | 排队中 | 10 |
in_progress | 生成中 | 50 |
completed | 成功 | 100 |
failed | 失败或已取消 | 100 |
建议每 5~10 秒轮询一次。上游仅保留最近 7 天的任务记录;视频下载链接有时效,请及时下载或转存。
响应示例
{
"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
任务 ID。
string
兼容旧接口的任务 ID,可能返回;值与
id 相同。string
对象类型,固定为
video。string
任务使用的模型名称。
string
任务状态:
queued、in_progress、completed 或 failed。integer
任务进度百分比。
integer
任务创建时间,Unix 时间戳(秒)。
integer
任务完成时间,Unix 时间戳(秒)。
integer
结果过期时间,Unix 时间戳(秒)。
string
产物时长(秒),字符串形式。
string
产物分辨率。
string
视频产物的限时下载地址。
object
扩展信息。成功时包含
url 与实际宽高比 ratio。object
失败原因,包含
code 与 message。错误码
| HTTP 状态码 | 说明 |
|---|---|
400 | 任务不存在或已超出 7 天查询窗口 |
401 | 鉴权失败 |
500 | 服务端错误 |