EcoPhase Docs - List video generation jobs

List MiniMax-H3 video jobs visible to the tenant that owns the current API key. Tenant isolation is always applied.

Basic request

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 defaults to 1. page_size defaults to 20 and currently has a maximum of 20. The compatibility list includes only jobs created in the most recent 7 days. Preserve task_id and use the single-job query endpoint when you need to retrieve an older job directly.

Filters

Query parameter	Meaning
`filter.status`	`queued`, `running`, `succeeded`, `failed`, or `cancelled`
`filter.task_ids`	One or more task IDs; repeat the MiniMax-H3 V2 parameter, for example `filter.task_ids=ID_1&filter.task_ids=ID_2`
`filter.model`	Currently `MiniMax-H3`
`filter.task_type`	Currently `generation`

Response

{
  "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 is the number of matching jobs inside the recent 7-day window, not the current page length. A successful task's content.url is short-lived. Do not log or retain it; query again after expiration.

Invalid query parameters return 400, an invalid key returns 401, and a rate limit returns 429 with Retry-After.