An aging warrior-monk in scorched ceremonial armor, a split ceramic mask and a humming prayer-band on his forearm + 0–4s: climbs silently along a cliffside terrace as insect-like surveyor drones comb the sun-bleached ruins, standing alone under as the camera rises over the ruined monastery. Sun-blasted post-apocalyptic sci-fi action, dust, heat haze, practical debris, sweeping crane tracking, silence broken only by wind.
MiniMax H3 Max API
MiniMax H3 post-trained by fal for speed: 5–15 s clips with first/last frame, ranked #1 on video arenas.
from$0.029/ second$0.03310% off
Model IDminimax-h3-max
Input
Text · Image
Output
Video
Provider
6 providers
Duration (s)
5 – 15
Resolution
480p · 768p · 1080p
Aspect ratio
16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9
Last 7 days · not enough recent requests for stats yet.
MiniMax H3 Max pricing
Prices are per unit; requests without a provider are routed to the cheapest provider that supports your parameters.
| Option | 480p | 768p | 1080p |
|---|---|---|---|
| All options | $0.029 / second 3 Credits | $0.047 / second 5 Credits | $0.094 / second 10 Credits |
Try MiniMax H3 Max before you integrate
Test output quality, compare provider prices and estimate cost before writing any code.
Input
Result
IdleProvider prices for this request
Enter a prompt to compare provider prices.
MiniMax H3 Max prompt examples
Ready-to-use prompts. Load one into the playground and tweak it.
14 prompts
Create a 5-second horizontal 16:9 cinematic short film. Keep the woman highly consistent: young woman with dark wavy hair and bangs, black shirt, calm but tense expression, sitting alone in the back seat of a car. Keep the rainy car window, red and cyan neon reflections, dark interior, realistic city night atmosphere, shallow depth of field, and intimate film-noir mood. Story conflict: she is not simply riding in a car. She has just made a decision that will betray someone she once trusted. Outside, someone is following her through the rain. She must choose whether to keep going or disappear before the car reaches the meeting point. 0-1s: Rain slides slowly down the car window. She sits still in the back seat, looking through the glass. Red neon light washes across her face like a warning. 1-2s: A phone on her lap vibrates and lights up, but the screen shows no readable text. She glances down, does not answer, and quietly tightens her hand around it. 2-3s: A bright pair of headlights appears behind the car, reflected in the wet window. Her eyes shift toward the reflection. She realizes the same car is still following. 3-4s: She stays calm. No panic. She turns the phone face down on the seat, then reaches into her coat and touches an old photograph or small envelope, as if saying goodbye to her old life. 4-5s: She looks toward the driver without raising her voice. Her lips barely move, silently implying: "Don't stop." Red light flashes across the window. End on her close-up through the rain-covered glass - no tears, no fear, only a cold final decision. Style: realistic cinematic thriller, urban rainy night, neon reflections, film noir mood, restrained acting, subtle emotional tension, natural face movement, real skin texture, wet glass detail, low-light cinematography, soft film grain, shallow depth of field, intimate close-up, high-end independent crime film opening. Avoid: exaggerated car chase, explosions, guns, fighting, crying, screaming, fake acting, overdramatic gestures, plastic skin, AI-looking face, changing identity, changing outfit, random text, subtitles, watermark, logo, distorted face, chaotic camera movement.
BLACK MIRROR TIDEFLATS / THE COLLAPSING SEA-CATHEDRAL Style: 8K cinematic. Photorealistic — no 3D render, no game engine, no game-cutscene aesthetic. Cinematography: naturalistic master cinematography. Lighting: high-contrast dramatic light. Cold storm-blue dusk across the flats vs. blinding sodium-orange furnace glow pouring from the toppling structure. The wet mirror surface doubles every light source into a second inverted world. Color: 60:30:10 — dominant gunmetal blue and wet slate (the tideflats and sky) / secondary sodium amber and rust-red (burning floodlights, corroded steel) / accent magnesium white and cobalt blue (the failing reactor core and its arc-flashes). Camera: physical cine lens. 180° shutter motion blur. Continuous handheld operator shake, motivated by the ground concussions rolling through the shallow water. Physics: gravity and inertia respected. Steel trusses buckle and fold under their own mass; spray, ash and salt mist obey atmospheric drag. SUBJECTS: @pilot: a lone figure in a salt-crusted pressure suit crewing a skeletal wind-skiff — a low wheeled land-yacht with a torn carbon sail — hunched at the tiller, cracked gold-tinted visor reflecting the falling structure, throwing twin walls of white spray from its outriggers. @cathedral: a colossal derelict sea-rig, a kilometre of rusted iron lattice and floodlight towers, listing and buckling as it collapses into the shallows, shedding burning platform decks and cobalt arc-flash from its ruptured core. LOCATION: an endless tidal flat of black volcanic glass under two inches of standing water — a perfect mirror to the horizon — broken by rotting mooring pylons and drifting curtains of salt mist, the skyline dominated by the burning collapse. ACTION — ONE CONTINUOUS TAKE, single unbroken handheld tracking shot, NO cuts, 15 seconds. 0:00–0:05 Medium-Wide on @pilot: camera tracks alongside the skiff as it carves between rotting pylons that burst into splinters and spray behind the wheels; the horizon tears open as @cathedral enters frame, leaning, trailing burning deck plates. 0:05–0:10 continuous zoom-in / tilt up: camera glides past the skiff and tilts up through the pylons onto the collapse; a core vessel detonates, the shockwave ripping the standing water into a flat sheet and bending the flare into a horizontal streak across frame. 0:10–0:15 Extreme Close-Up on @cathedral: telephoto-compressed view of the disintegrating rig against the sky, steel plate peeling and glowing white-hot, raining burning debris down toward the camera. CONSTRAINTS: 16:9 anamorphic widescreen. ONE CONTINUOUS SHOT — absolutely NO hard cuts. Telephoto compression during the zoom. No slow-motion. Photoreal throughout. AUDIO (NO MUSIC): deep structural groan of failing steel, the hiss and slap of water under the hull, tearing-metal screech from above, the rigging-hum and canvas crack of the skiff at speed, wind roar across open flats.
He explodes upward out of the black. Both arms drive toward the falling apple, body twisting, white linen sleeves snapping taut then bunching as his shoulders roll. The apple tumbles fast, end over end, its stem whipping. He mistimes it — the fruit glances off his fingertips and spins away; he lunges after it, throwing his weight sideways, hair swinging across his face, eyes flashing wide. He catches it hard against his palm, the impact shoving his arm back and down, linen collapsing in loose folds. He pulls it in against his chest, breathing hard, and breaks into a grin as he looks straight into the lens. The candlelight jumps with every movement, flaring across his forearms and guttering into darkness behind him.
Create a 5-second live-action Hollywood film shot in a bright university library. A thoughtful professor stands in a medium shot, turns slightly toward an unseen student, and calmly says, “What is the real?” Natural daylight, professional cinema camera, realistic performance, subtle camera drift, no close-up, no dark lighting, perfect lip sync.
Exactly 5 seconds. Inside a bright sterile laboratory, a cryogenic chamber opens and cold vapor spills across the floor. A confused man slowly sits up. A scientist steps forward and says, “Welcome back.” The man asks, “What year is it?” The scientist hesitates as the camera gently pulls backward. Photorealistic Hollywood science-fiction drama, soft white daylight, realistic vapor, restrained acting, accurate lip sync, no extreme close-up.
MiniMax H3 Max API reference
Endpoints, request fields and runnable examples for this model.
Base URL
https://01router.com/api/v1Quick start
Set API_KEY to your project key, then run a sample from your server. Replace example media URLs with your own public URLs.
Auto-routing chooses a provider that supports the request. Select a provider to see its input constraints and pinned request examples.
curl https://01router.com/api/v1/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "minimax-h3-max",
"input": {
"prompt": "A cinematic shot of a red fox running through snow",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
}
}
JSON
# Replace GENERATION_ID with the id returned above; poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/GENERATION_ID -H "Authorization: Bearer $API_KEY"Endpoints
Only endpoints relevant to this model are listed. Paths below include /api/v1. Click an endpoint to read its usage.
/api/v1/generationsCreate a generation (charges credits) · API key required
/api/v1/generations/{id}Get a generation; polls the provider while running · API key required
/api/v1/generations/{id}/cancelCancel a running generation (credits refunded) · API key required
/api/v1/quotePrice a request on every provider (no charge, no key needed) · Public · no key
/api/v1/models/minimax-h3-maxGet one model · Public · no key
Authentication
Send your API key as a Bearer token. Requests are billed to the key owner's credits.
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonInput
Send JSON with Content-Type: application/json. Model parameters belong inside input; model, provider and callback_url are top-level fields.
Request body
| Name | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | "minimax-h3-max" |
| provider | string | No | Pin a provider; omit to auto-route to the cheapest. One of: fal | 01router | apimart | evolink | atlascloud | vercel |
| input | object | Yes | Model parameters, see the input fields below. |
| callback_url | string | No | Optional public HTTPS webhook URL. The final task result is signed and delivered here; polling remains available. |
input · input fields
Required fields are marked explicitly. Other fields use the listed defaults when omitted.
| Name | Type | Required | Values | Default |
|---|---|---|---|---|
| prompt* | string | Yes | — | — |
| image_url Optional start image (image-to-video) | string | No | — | — |
| end_image_url | string | No | — | — |
| duration | integer | No | min: 5 · max: 15 | 5 |
| resolution | string | No | 480p | 768p | 1080p | 768p |
| aspect_ratio | string | No | 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:9 | 16:9 |
Output
Creating a task does not mean generation has finished. Keep its id, poll until succeeded or failed, then read outputs or error. Amounts below are illustrative; actual charges depend on the request.
Task submitted
{
"id": "gen_example",
"object": "generation",
"model": "minimax-h3-max",
"type": "video",
"provider": "fal",
"status": "processing",
"input": {
"prompt": "A cinematic shot of a red fox running through snow",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
},
"outputs": [],
"error": null,
"credits": 0,
"price_usd": 0,
"created_at": "2026-10-25T08:00:00.000Z",
"completed_at": null
}Task completed
{
"id": "gen_example",
"object": "generation",
"model": "minimax-h3-max",
"type": "video",
"provider": "fal",
"status": "succeeded",
"input": {
"prompt": "A cinematic shot of a red fox running through snow",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
},
"outputs": [
"https://example.com/output.mp4"
],
"error": null,
"credits": 0,
"price_usd": 0,
"created_at": "2026-10-25T08:00:00.000Z",
"completed_at": "2026-10-25T08:01:00.000Z"
}Response fields
| Name | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Generation ID. Use it to query or cancel this task. |
| object | string | Yes | generation |
| model | string | Yes | minimax-h3-max |
| type | string | Yes | video |
| provider | string | Yes | Provider |
| status | string | Yes | queued → processing → succeeded / failed. Stop polling at either terminal state. |
| input | object | Yes | Model parameters, see the input fields below. |
| outputs | string[] | Yes | Result URLs. Empty while processing; read after succeeded and save the files promptly. |
| error | string | null | Yes | Failure reason, or null when no failure is reported. |
| credits | number | Yes | Credits charged for this request. |
| price_usd | number | Yes | Request price in USD. |
| created_at | string | Yes | Creation time in ISO 8601 format. |
| completed_at | string | null | Yes | Completion time in ISO 8601 format; null before completion. |
Get the result
Poll every few seconds until status is succeeded or failed. Output URLs are provider-hosted and may expire — download them promptly. Or pass callback_url to get the result pushed.
curl "https://01router.com/api/v1/generations/GENERATION_ID" \
-H "Authorization: Bearer $API_KEY"queued → processing → succeeded / failed. Stop polling at either terminal state. Result URLs. Empty while processing; read after succeeded and save the files promptly.
Cancel a task
Cancellation depends on provider support and task state. A confirmed cancellation returns status: failed and error: Canceled by user. Unsupported or completed tasks return 409 not_cancelable.
curl -X POST "https://01router.com/api/v1/generations/GENERATION_ID/cancel" \
-H "Authorization: Bearer $API_KEY"Quote
Same body as creating a generation. Returns every available provider sorted by price, plus the ones that cannot serve the request and why.
curl "https://01router.com/api/v1/quote" -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
"model": "minimax-h3-max",
"input": {
"prompt": "A cinematic shot of a red fox running through snow",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
}
}
JSONModel schema
This public endpoint returns the model parameters and each provider’s supported constraints and prices.
curl "https://01router.com/api/v1/models/minimax-h3-max"Errors
Check the HTTP status and error.message. Fix the request before retrying validation or authentication errors. A failed generation is reported in status and error on the task itself.
{
"error": {
"message": "Invalid or missing API key",
"code": "unauthorized"
}
}400Invalid body or parameter value
401Missing or invalid API key
402Not enough credits
404Unknown model or generation
409The task cannot be canceled (already finished, or the provider does not support canceling)
429Too many requests — retry after the given seconds
502Every provider rejected the task (credits refunded)
Use with AI
Give your coding assistant this model reference: endpoints, input constraints, output fields and request examples in plain text.
How does MiniMax H3 Max compare?
Specs and starting prices side by side. Test with the same prompt before you choose.
| MiniMax H3 Max | MiniMax H3 | Grok Imagine Video 1.5 | Seedance 2.5 | |
|---|---|---|---|---|
| Vendor | MiniMax | MiniMax | xAI | ByteDance |
| Starting price | $0.029 / second | $0.036 / second | $0.011 / second | $0.086 / second |
| Input | Text · Image | Text · Image | Text · Image | Text · Image |
| Provider | 6 providers | 7 providers | 10 providers | 9 providers |
| Duration (s) | 5 – 15 | 5 – 15 | 1 – 15 | 4 – 30 |
| Resolution | 480p · 768p · 1080p | 768p · 2k | 480p · 720p · 1080p | 480p · 720p · 1080p |
| Aspect ratio | 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 | 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 | 16:9 · 4:3 · 3:2 · 1:1 · 2:3 · 3:4 · 9:16 | 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 |
MiniMax H3 Max API FAQ
What is MiniMax H3 Max good at?
Fast, high-quality short clips with expressive acting and timed beats. Writing the action second by second (0-1s, 1-2s, ...) gives very precise control.
Which resolutions and durations are supported?
5 to 15 seconds at 480p, 768p or 1080p. For 2K output use MiniMax H3.
Can I set the first and last frame?
Yes. Pass image_url as the first frame and optionally end_image_url as the last frame.
How fast is it?
H3 Max is among the fastest video models: short 768p clips often finish in seconds, and longer clips in well under a minute.
How is it billed on 01router?
Per output second at the chosen resolution; see the pricing table. Failed generations are refunded.
Related models
Other models you can call with the same API key.
MiniMax H3
MiniMax Hailuo H3 with native 768p and 2K output, 4–15 s, first/last frame.
Grok Imagine Video 1.5
Grok Imagine Video 1.5: 1–15 second videos with synchronized audio, at 480p, 720p or 1080p. Image-to-video follows the source image aspect ratio.
Seedance 2.5
ByteDance’s flagship video model: up to 30 s in one pass, native synchronized audio, first/last-frame control.
Grok Imagine Video 1.5 Lite
Grok Imagine Video 1.5 Lite: 1–15 second videos with synchronized audio, at 480p, 720p or 1080p. Image-to-video follows the source image aspect ratio.
Seedance 2.0
Multi-shot Seedance generation with synchronized audio and first/last-frame control, 4–15 s.
Seedance 2.0 Mini
Faster, lower-cost Seedance 2.0 for drafts and high-volume generation (480p/720p).