跳到主要内容

查询 MiniMax-H3 任务列表

列表接口返回当前用户在 PinduCloud 创建的 H3 任务，包含普通视频生成、视频再生成 和 Context-IR。它使用 Query 参数筛选，不接收 JSON 请求体。

请求​

GET https://video.pinducloud.com.cn/hailuo/v2/query/video_generation
curl --get "$BASE_URL/hailuo/v2/query/video_generation" \
  --header "Authorization: Bearer $API_KEY" \
  --data-urlencode "page_num=1" \
  --data-urlencode "page_size=20" \
  --data-urlencode "filter.status=succeeded" \
  --data-urlencode "filter.task_type=generation"

查询参数​

参数类型和限制默认值说明
page_num整数，1~1000001页码
page_size整数，1~10020每页数量
filter.model只能为 MiniMax-H3空按模型过滤
filter.statusqueued、running、succeeded、failed、cancelled空按状态过滤
filter.task_typegeneration、regeneration、h3_context_ir空按任务类型过滤
filter.task_ids可重复，最多 100 个空按 PinduCloud 任务 ID过滤

列表查询结果按当前用户隔离。重复传入任务 ID：

curl --get "$BASE_URL/hailuo/v2/query/video_generation" \
  --header "Authorization: Bearer $API_KEY" \
  --data-urlencode "filter.task_ids=task_gateway_h3_01" \
  --data-urlencode "filter.task_ids=task_gateway_h3_02"

响应​

{
  "items": [
    {
      "id": "task_gateway_h3_01",
      "model": "MiniMax-H3",
      "status": "succeeded",
      "task_type": "generation",
      "modality": "video",
      "resolution": "2K",
      "duration": 5,
      "content": {"url": "https://cdn.example.com/output.mp4"},
      "usage": {
        "total_seconds": 5,
        "input_seconds": 0,
        "output_seconds": 5,
        "input_image_count": 0
      }
    },
    {
      "id": "task_gateway_ir_01",
      "model": "MiniMax-H3",
      "status": "running",
      "task_type": "h3_context_ir",
      "modality": "text"
    }
  ],
  "total": 2
}

items 中每项使用与查询单个任务相同的任务结构；任务未完成时不应 假定 content 或 usage 已存在。