MiniMax-H3 — Image to Video


Model ID	`minimax/minimax-h3-i2v`
Family	`minimax-h3`
Task	`image-to-video`
Modality	Video
Upstream	MiniMax-H3 (official MiniMax API)

MiniMax-H3 image-to-video uses your image as the opening frame and animates it with synchronized audio at 2K. The aspect ratio follows the input image. Clips are billed per second of output.

Endpoint

POST https://routerbase.com/v1/videos/generations

Async — returns {id, status: "pending"}; poll GET /v1/videos/generations/{id} until success or failed.

Parameters

string

required

Text prompt describing how the first frame should be animated. Max 7000 characters.

string[]

required

A single-element array with the URL of the first-frame image to animate.

"6" | "10"

default:"\"6\""

Length of the generated clip in seconds. Drives the price (billed per second of output).

"2K"

default:"\"2K\""

Output resolution.

"adaptive" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9"

default:"\"adaptive\""

Aspect ratio. Defaults to adaptive (derived from the input image); pass a concrete value to override.

Example

curl https://routerbase.com/v1/videos/generations \
  -H "Authorization: Bearer $ROUTERBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/minimax-h3-i2v",
    "prompt": "the camera slowly pushes in as the waves roll",
    "image_urls": ["https://example.com/first-frame.png"],
    "duration": "6",
    "resolution": "2K"
  }'

{ "id": "task_abc123…", "status": "pending", "model": "minimax/minimax-h3-i2v" }

Poll until terminal:

curl https://routerbase.com/v1/videos/generations/task_abc123… \
  -H "Authorization: Bearer $ROUTERBASE_API_KEY"

{
  "id": "task_abc123…",
  "status": "success",
  "data": [{ "url": "https://…mp4" }]
}

Get Started

API Reference

MiniMax-H3 — Image to Video

Endpoint

Parameters

Example

​Endpoint

​Parameters

​Example

Endpoint

Parameters

Example