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.
Input
Text prompt for video generation
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).
Optional URL of the image to use as the last frame, for first-to-last keyframe generation.
The native generation resolution of the video. Allowed values: 480P, 768P.
515
The duration of the video in seconds. Range: 5 to 15.
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.
Random seed. A random seed is selected when omitted.
Idle
Example output — click Run to generate your own
Production endpoint
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
POST
https://api.sandbase.ai/v1/runModel ID
minimax/h3-max/image-to-video01
Input 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" |
02
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
03
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