MiniMax-H3 video generation

Call MiniMax-H3 through APIMaster's OpenAI-compatible video API. Text-to-video requests run asynchronously.

Base URL: https://apimaster.ai/v1 is https://apimaster.ai/v1. Create MiniMax-H3 tasks with POST https://apimaster.ai/v1/video/generations.

Create a video task

POST https://apimaster.ai/v1/video/generations

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Field	Type	Required	Description
model	string	yes	Must be MiniMax-H3
prompt	string	yes	Description of the video
duration	integer	no	4–15 seconds; defaults to 4
size	string	no	768P or 2K; defaults to 768P
ratio	string	no	Aspect ratio; defaults to 16:9
metadata	object	no	Extra metadata; explicit request fields take precedence

curl -s "https://apimaster.ai/v1/video/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "prompt": "A calm ocean at sunrise, gentle waves, cinematic wide shot",
    "duration": 4,
    "size": "768P",
    "ratio": "16:9"
  }'

The response returns a task ID immediately:

{
  "id": "task_xxxxxxxx",
  "task_id": "task_xxxxxxxx",
  "object": "video",
  "model": "MiniMax-H3",
  "status": "queued",
  "progress": 0,
  "created_at": 1786436206
}

Poll task status

GET https://apimaster.ai/v1/videos/{task_id}

curl -s "https://apimaster.ai/v1/videos/task_xxxxxxxx" \
  -H "Authorization: Bearer YOUR_API_KEY"

Possible states are queued, running, completed, and failed. A completed task includes the video URL:

{
  "id": "task_xxxxxxxx",
  "status": "completed",
  "progress": 100,
  "url": "https://apimaster.ai/v1/videos/task_xxxxxxxx/content"
}

Wait 10–20 seconds after submission, then poll every 3–5 seconds.

Download the video

GET https://apimaster.ai/v1/videos/{task_id}/content

curl -L "https://apimaster.ai/v1/videos/task_xxxxxxxx/content" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o output.mp4

Video URLs may expire. Download and store the MP4 promptly after completion.

Limits and errors

• model must be MiniMax-H3.
• duration supports 4–15 seconds.
• size supports 768P and 2K.
• A disabled or insufficient-balance channel returns a routing or upstream balance error; check the account balance and channel status first.
• Do not download a task unless its status is completed.