MiniMaxMediumUltra

MiniMax Hailuo-03 (H3) Image to Video

MiniMax Hailuo-03 (H3) image-to-video via Fal.AI. 2K video generation from a first-frame image, 5-15 second duration, native audio, with optional first-to-last keyframe control via end_image_url.

3020 credits

per second, tiered by resolution

Generates video directly from a single first-frame image

Up to 2K resolution output

5-15 second adjustable duration

Native audio generated alongside the video

Optional first-to-last keyframe control via end_image_url

Output aspect ratio automatically follows the input image

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/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": "2K"
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	-	Text prompt for video generation
`duration`	integer	No	5	The duration of the video in seconds.
`resolution`	string	No	2K	The resolution of the generated video. 768P2K
`image_url`	string	Yes	-	URL of the image to use as the first frame. The output aspect ratio 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.

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

Slow pull-back reveal from a landscape photo

Animate a still landscape image into a 5-second 2K clip where the camera pulls back to reveal the full scene.

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/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": "2K"
  }
}'

First-to-last keyframe transition

Provide both a starting image and an ending image so the model generates a longer transition video between the two.

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/image-to-video",
  "input": {
    "prompt": "A smooth cinematic transition as the scene transforms from day to night.",
    "image_url": "https://example.com/start-frame.jpg",
    "end_image_url": "https://example.com/end-frame.jpg",
    "duration": 10,
    "resolution": "2K"
  }
}'