MiniMax H3 Video Generation

Generate 4–15 second videos through POST https://api.acedata.cloud/minimax/videos. Use the V2 multimodal content array to supply the prompt and optional reference media.

Setup: See authentication. The HTTP API waits for the final result by default. Agents and MCP clients should send "async": true, save the returned task_id, then use async task polling with POST /minimax/tasks. MiniMax MCP generation tools expose async and default it to true.

Contract

Parameter	Values	Default
`model`	`MiniMax-H3`	required
`content`	array of prompt and optional media items	required
`resolution`	`768P`, `2K`	required
`duration`	integer 4–15	required
`ratio`	`adaptive`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`	omitted
`async`	`true`, `false`	`false` at the HTTP API; `true` in MiniMax MCP tools
`callback_url`	public HTTP(S) webhook; also enables async mode	omitted

Each content item has a type of text, image_url, video_url, or audio_url; set the matching field to the text or public URL. Media items use a role:

Role	Use
`first_frame`	Starting image
`last_frame`	Ending image
`reference_image`	Reference image
`reference_video`	Reference video
`reference_audio`	Reference audio

Include a text item with the generation prompt in every request.

Text to video

curl -X POST https://api.acedata.cloud/minimax/videos \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "A red fox running through a snowy forest at dawn, low tracking shot"
      }
    ],
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 4,
    "async": true
  }'

First and last frame video

{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "A camera slowly pushes in as the character walks into the sunrise."
    },
    {
      "type": "image_url",
      "image_url": {"url": "https://cdn.acedata.cloud/first-frame.png"},
      "role": "first_frame"
    },
    {
      "type": "image_url",
      "image_url": {"url": "https://cdn.acedata.cloud/last-frame.png"},
      "role": "last_frame"
    }
  ],
  "resolution": "768P",
  "ratio": "9:16",
  "duration": 8,
  "async": true
}

Reference-guided video

{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "A dancer moves naturally to the rhythm."
    },
    {
      "type": "image_url",
      "image_url": {"url": "https://cdn.acedata.cloud/reference.png"},
      "role": "reference_image"
    },
    {
      "type": "audio_url",
      "audio_url": {"url": "https://cdn.acedata.cloud/reference.wav"},
      "role": "reference_audio"
    }
  ],
  "resolution": "768P",
  "ratio": "9:16",
  "duration": 8,
  "async": true
}

Poll a task

curl -X POST https://api.acedata.cloud/minimax/tasks \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"action":"retrieve","id":"TASK_ID"}'

Continue polling about every five seconds until the task reaches a terminal state. Use retrieve_batch with ids to check several tasks, or delete with id to remove a task. Batch listing also accepts limit, offset, created_at_min, and created_at_max.

Gotchas

Do not send action to /minimax/videos; the API infers the mode from media inputs.
duration must be an integer, not a decimal.
Put the prompt in a content item with type: "text"; do not send a top-level prompt.
Use first_frame, last_frame, and reference roles explicitly; do not rely on item order to determine an image's role.
Use public URLs that the generation service can download for every media item.
Returned videos are served from AceDataCloud CDN.

minimax-video