多元探索 API多元探索 API
OpenAI Format

MiniMax Task Query

Use `GET /v1/videos/{task_id}` to query MiniMax video task status and results.

GEThttps://zx1.deepwl.net/v1/videos/{task_id}
Request
curl https://zx1.deepwl.net/v1/videos/task_a1b2c3d4e5f6 \
  -H "Authorization: Bearer YOUR_API_KEY"
Response
{
  "id": "task_a1b2c3d4e5f6",
  "object": "video",
  "model": "MiniMax-H3",
  "status": "completed",
  "progress": 100,
  "created_at": 1785125529,
  "completed_at": 1785125946,
  "seconds": "5",
  "size": "2K",
  "video_url": "https://cdn.example.com/h3-generated-2k-output.mp4",
  "metadata": {
    "url": "https://cdn.example.com/h3-generated-2k-output.mp4",
    "ratio": "16:9"
  }
}

OpenAI-format query entry point that looks up the status of a video generation or regeneration task by task ID. If the task was submitted via POST /v1/video/create, please use Query Task.

Once the task succeeds (status=completed), the asset URL is available in the video_url field.

Status transitions

statusMeaningprogress
queuedQueued10
in_progressGenerating50
completedSucceeded100
failedFailed or cancelled100
  • Recommended polling interval: 5–10 seconds.
  • Upstream only retains task records for the last 7 days; task IDs beyond the window will fail to query.
  • Video download links expire; download or store them promptly.

Request Headers

Authorizationstring必填

Authentication header. Uses a Bearer token, e.g. Bearer YOUR_API_KEY.

Request Parameters

task_idstring必填

Task ID (the id returned by the creation API).

Request Example

Response Example

Response Fields

idstring

Task ID. Gateway public ID, does not expose the upstream identifier.

task_idstring

Task ID (legacy compatibility field, to be deprecated; same value as id). Use id for new integrations.

objectstring

Always video.

modelstring

The model used by the task.

statusstring

Task status: queued / in_progress / completed / failed.

progressinteger

Task progress percentage, 0–100.

created_atinteger

Task creation time (Unix timestamp, seconds).

completed_atinteger

Task completion time (Unix timestamp, seconds). Returned after completion.

expires_atinteger

Asset expiration time (Unix timestamp, seconds).

secondsstring

Asset duration in seconds, as a string.

sizestring

Asset resolution.

video_urlstring

Time-limited download URL of the video asset. Returned after the task succeeds; download or store it promptly.

metadataobject

Extended info. After success, contains url (same as video_url) and ratio (actual aspect ratio).

errorobject

Error info on failure, including upstream code and message.

Error Codes

Status CodeDescription
400Task not found or beyond the 7-day query window
401Authentication failed
500Internal server error