Video Generation API

Query a video generation job

Use the task_id from create to query one MiniMax-H3 video job.

Request

bash
curl "https://ecotoken.ecophase-ai.com/v2/query/video_generation/YOUR_TASK_ID" \
  -H "Authorization: Bearer $VIDEO_API_KEY"

Response

The response preserves the requested duration and the final selected ratio. Current output is always resolution: "768P", 24 FPS, and MP4/H.264; it never reports 2K. For I2VA adaptive, the runtime selects a 768P ratio from the first frame, and the final task projection is authoritative.

json
{
  "task": {
    "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": 8,
    "usage": {
      "total_seconds": 0,
      "input_seconds": 0,
      "output_seconds": 0,
      "input_image_count": 1
    },
    "ratio": "adaptive",
    "task_type": "generation",
    "modality": "video"
  }
}

Status and output

statusMeaning
queuedAwaiting admission or scheduling
runningExecuting on an H3 node or uploading output
succeededOutput generated and registered
failedGeneration failed; inspect task.error
cancelledCancelled

Use task.content.url only after succeeded. It is a short-lived object-storage download grant, and the client downloads directly. Video bytes do not pass through Sub2API, the product service, or the control plane. Query again after expiration instead of retaining or logging the signed URL. usage retains the MiniMax-H3 response shape; video is currently billing-neutral, so counters remain 0 without authoritative runtime usage evidence.

A missing or cross-tenant task returns 400; an invalid or revoked key returns 401; a rate limit returns 429 with Retry-After.

Continue with List video jobs and Cancel or delete a job.

EcoPhase Docs - Query a video generation job - EcoPhase.AI