MiniMax-H3 — Reference to Video


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

MiniMax-H3 reference-to-video takes a subject/character reference image and keeps that identity consistent across the generated 2K clip, driven by your text prompt. Unlike image-to-video, the reference image is not used as the literal first frame. 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 the scene and action for the referenced subject. Max 7000 characters.

string[]

required

A single-element array with the URL of the subject/character reference image whose identity should be preserved across the clip.

"6" | "10"

default:"\"6\""

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

"2K"

default:"\"2K\""

Output resolution.

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

default:"\"16:9\""

Aspect ratio. Defaults to a concrete 16:9; adaptive is also accepted.

Example

curl https://routerbase.com/v1/videos/generations \
  -H "Authorization: Bearer $ROUTERBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/minimax-h3-r2v",
    "prompt": "the same character walking through a neon-lit market at night",
    "image_urls": ["https://example.com/character-reference.png"],
    "duration": "6",
    "resolution": "2K",
    "ratio": "16:9"
  }'

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

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 — Reference to Video

Endpoint

Parameters

Example

​Endpoint

​Parameters

​Example

Endpoint

Parameters

Example