05-查询任务列表
查询任务列表
文档版本：v1.0.0 | 最后更新：2026-08-13 本平台已完整适配 MiniMax 视频生成 V2（MiniMax-H3）官方接口，请求与响应均为透传，参数语义与官方一致。
GET https://platform.shuyanai.com/hailuo/v2/query/video_generation查询参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
page_num | integer | 否 | 1 | 页码，从 1 开始 |
page_size | integer | 否 | 20 | 每页数量 |
filter.status | string (enum) | 否 | — | 按任务状态过滤：queued / running / succeeded / failed / cancelled |
filter.task_ids | array | 否 | — | 按任务 ID 过滤，可重复传参指定多个 |
filter.model | string | 否 | — | 按模型名称过滤（单个模型），如 MiniMax-H3 |
filter.task_type | string (enum) | 否 | — | 按任务类型过滤：generation / regeneration / h3_context_ir |
请求示例
响应示例
{
"items": [
{
"id": "424635601932571",
"model": "MiniMax-H3",
"status": "succeeded",
"created_at": 1785225940,
"updated_at": 1785226100,
"content": {
"url": "https://cdn.example.com/output.mp4"
},
"resolution": "2K",
"duration": 5,
"usage": {
"total_seconds": 5,
"input_seconds": 0,
"output_seconds": 5,
"input_image_count": 0
},
"ratio": "adaptive",
"task_type": "generation"
},
{
"id": "424635601932588",
"model": "MiniMax-H3",
"status": "running",
"created_at": 1785225940,
"updated_at": 1785226100,
"resolution": "2K",
"duration": 10,
"usage": {
"total_seconds": 0,
"input_seconds": 0,
"output_seconds": 0,
"input_image_count": 0
},
"ratio": "9:16",
"task_type": "generation"
}
],
"total": 476
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
items | array | 任务列表，元素结构与查询任务的 task 对象一致 |
total | integer | 符合过滤条件的任务总数 |
