MiniMaxMediumUltra

MiniMax H3 Max Image to Video

MiniMax H3 Max image-to-video via Fal.AI. fal's post-trained variant of MiniMax Hailuo-03 (H3), tuned for stronger prompt adherence and better aesthetics — animates a first-frame image (optional last frame for keyframe control) into 5-15 second clips with native audio at 480P/768P native or 1080P refined output.

930 credits

per 5s 768P video — billed per second (480P 116/s, 768P 186/s, 1080P 372/s)

Animates a first-frame image with stronger prompt adherence

Optional last frame for first-to-last keyframe control

Native audio generated alongside the video

480P/768P native generation or 1080P refinement, billed per second

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "minimax/h3-max/image-to-video",
  "input": {
    "prompt": "The camera slowly pulls back from the scene, revealing the full landscape as clouds drift overhead and light shifts across the terrain.",
    "image_url": "https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg",
    "duration": 5,
    "resolution": "768P"
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	-	Text prompt for video generation (up to 50,000 characters).
`image_url`	string	Yes	-	URL of the image to use as the first frame. The output canvas follows this image.
`end_image_url`	string	No	-	Optional URL of the image to use as the last frame, for first-to-last keyframe generation.
`duration`	integer	No	5	The duration of the video in seconds (5-15), billed per second.
`resolution`	string	No	768P	480P and 768P are native generation modes; 1080P is latent refinement from a native 768P source. 480P768P1080P
`prompt_expansion_mode`	string	No	balanced	How much effort to spend rewriting the prompt before generation. 'disabled' skips expansion, 'balanced' returns in about a second, 'quality' spends up to ~30s on a richer prompt. disabledbalancedquality
`enable_safety_checker`	boolean	No	true	If set to true, the safety checker will be enabled.
`seed`	integer	No	-	Random seed. A random seed is selected when omitted.

How to Provide File Input

There are 3 ways to provide files for the image_urlend_image_url parameters:

Recommended

Image URL

Pass a publicly accessible URL directly. With the Storage API (POST /v1/files/upload-url) the file uploads straight to S3 (50MB per file) and you pass the returned file_url.

{
  "model": "minimax/h3-max/image-to-video",
  "input": {
    "prompt": "your prompt here",
    "image_url": "https://example.com/image.jpg"
  }
}

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step, but the bytes pass through the API server so the whole request is capped at 10MB.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=minimax/h3-max/image-to-video" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:image_url=@your_file.png"

See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Landscape pull-back

The camera pulls back from a still landscape image at the default 768P.

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "minimax/h3-max/image-to-video",
  "input": {
    "prompt": "The camera slowly pulls back from the scene, revealing the full landscape as clouds drift overhead and light shifts across the terrain.",
    "image_url": "https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg",
    "duration": 5,
    "resolution": "768P"
  }
}'

Quick 480P draft

A cheaper 8-second 480P draft to check motion before the final render.

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "minimax/h3-max/image-to-video",
  "input": {
    "prompt": "Clouds race across the sky as sunlight sweeps over the hills, time-lapse feel.",
    "image_url": "https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg",
    "duration": 8,
    "resolution": "480P"
  }
}'