minimax/h3-max/image-to-video
H3 Max is MiniMax's image-to-video AI model. Bring static images to life with fluid animation, consistent character motion, and professional-grade video output.
PNG, JPEG, WebP, or GIF · 20 MiB maximum
PNG, JPEG, WebP, or GIF · 20 MiB maximum
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runminimax/h3-max/image-to-videoInput Schema
7 parameters · 2 required · 5 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
image | string | Required | Optional URL of the image to use as the first frame. When provided, the output aspect ratio follows this image. When omitted, the request is handled as text-to-video (16:9 by default). |
prompt | string | Required | Text prompt for video generation · Min length: 1 · Max length: 50000 |
seed | integer | Optional | Random seed. A random seed is selected when omitted. |
duration | integer | Optional | The duration of the video in seconds. · Min: 5 · Max: 15 · Default: 5 |
end_image | string | Optional | Optional URL of the image to use as the last frame, for first-to-last keyframe generation. |
resolution | string | Optional | The native generation resolution of the video. · Options: 480P, 768P · Default: "768P" 480P768P |
prompt_expansion_mode | string | Optional | How much effort to spend rewriting the prompt before generation. 'balanced' returns in about a second. 'quality' spends up to ~30s on a richer prompt. · Default: "balanced" |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "minimax/h3-max/image-to-video",
"image": "https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg",
"prompt": "The camera slowly pulls back from the scene, revealing the full landscape as clouds drift overhead and light shifts across the terrain.",
"duration": 5,
"resolution": "768P",
"prompt_expansion_mode": "balanced"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
MiniMax H3 Max Image to Video
Animate a starting image, with an optional ending image, using MiniMax H3 Max. The model supports prompt-directed motion, camera behavior, dialogue, and native audiovisual output.
Pricing
Current fal promotional rates are $0.0125 per second at 480P and $0.02 per second at 768P through September 7, 2026. Completed-task duration is used when available; otherwise the requested duration is used.
Technical Specs
- Model ID:
minimax/h3-max/image-to-video - Required inputs:
prompt, starting image - Optional input: ending image
- Duration: 5–15 seconds; default 5
- Resolution:
480Por768P; default768P - Output: downloadable video URL
- Execution: asynchronous