Retrieve video task

Look up a minimax/minimax-h3 task in MiniMax's shape.

Authorization

header

AuthorizationstringRequired

Bearer <your RouterOne key> Your RouterOne API key.

Request

idstringRequired

The RouterOne task ID returned at submit time.

Response

200response

Always 200, finished or not -- the state is in task.status.

404response

No such task in this workspace.

It reads the same task as the unified endpoint#

One task table, one ID, one set of data, rendered two ways at the very end. It exists because MiniMax clients construct this address themselves; without it, changing base_url would give you a successful submit and a 404 on retrieval.

The response fields match MiniMax's official query endpoint: besides status, output and failure reason, it includes model, created_at / updated_at, resolution, duration, ratio, task_type, modality and usage. Fields in usage reported by the upstream (such as token counts and reference audio seconds) are returned as is; fields it does not report are omitted. The amount charged (cost) is available only from the unified endpoint.

Status#

Always 200, finished or not. The state lives in task.status.

Note cancelled is spelled with two l characters, matching the upstream.

Polling#

Elapsed time is dominated by queueing rather than scaling with the requested duration. Suggested: do not poll during the first 20 seconds, then poll every 10-15 seconds — the upstream's own suggested interval is 10 seconds. Do not extrapolate timeouts linearly from output length.

Artifact URL#

task.content.url points at our storage, not the upstream's provider-signed, expiring address. Those URLs are cleaned up periodically — download anything you need to keep.

curl https://gateway.routerone.ai/v2/query/video_generation/{id} \
  -H "Authorization: Bearer $ROUTERONE_API_KEY"

{
  "task": {
    "id": "<string>",
    "model": "<string>",
    "status": "queued",
    "content": {
      "url": "<string>"
    },
    "error": {
      "code": "<string>",
      "message": "<string>"
    },
    "created_at": 0,
    "updated_at": 0,
    "resolution": "768P",
    "duration": 5,
    "usage": {
      "total_seconds": 0,
      "input_seconds": 0,
      "output_seconds": 0,
      "input_image_count": 0,
      "input_audio_seconds": 0,
      "total_tokens": 0,
      "prompt_tokens": 0,
      "completion_tokens": 0
    },
    "ratio": "16:9",
    "task_type": "generation",
    "modality": "video"
  },
  "request_id": "<string>"
}