EcoPhase 文档 - 查询视频生成任务列表

查询当前 API Key 所属租户可见的 MiniMax-H3 视频任务。服务端按租户隔离，不会返回其他租户的任务。

基本请求

curl --get "https://ecotoken.ecophase-ai.com/v2/query/video_generation" \
  -H "Authorization: Bearer $VIDEO_API_KEY" \
  --data-urlencode "page_num=1" \
  --data-urlencode "page_size=20" \
  --data-urlencode "filter.status=succeeded" \
  --data-urlencode "filter.model=MiniMax-H3" \
  --data-urlencode "filter.task_ids=YOUR_TASK_ID_1" \
  --data-urlencode "filter.task_ids=YOUR_TASK_ID_2"

page_num 默认 1，page_size 默认 20，最大 20。兼容列表只覆盖最近 7 天创建的任务；更早的任务不在这里，请保存 task_id 用单任务查询按需拉取。

筛选条件

Query 参数	说明
`filter.status`	按 `queued`、`running`、`succeeded`、`failed` 或 `cancelled` 筛选
`filter.task_ids`	按一个或多个任务 ID 筛选；按 MiniMax-H3 V2 格式重复传同名参数，如 `filter.task_ids=ID_1&filter.task_ids=ID_2`
`filter.model`	当前使用 `MiniMax-H3`
`filter.task_type`	当前使用 `generation`

响应

{
  "items": [
    {
      "id": "YOUR_TASK_ID",
      "model": "MiniMax-H3",
      "status": "succeeded",
      "created_at": 1787788800,
      "updated_at": 1787789100,
      "content": {"url": "https://SHORT_LIVED_DOWNLOAD_URL"},
      "resolution": "768P",
      "duration": 5,
      "usage": {
        "total_seconds": 0,
        "input_seconds": 0,
        "output_seconds": 0,
        "input_image_count": 0
      },
      "ratio": "16:9",
      "task_type": "generation",
      "modality": "video"
    }
  ],
  "total": 1
}

total 是最近 7 天窗口内筛选后的任务总数，不是当前页数量。成功任务的 content.url 是短期下载链接，不要记录或长期保存，过期后重新查询即可。

Query 参数无效返回 400，API Key 无效返回 401，达到速率限制返回 429 并带 Retry-After。