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.

MiniMax·VideoAvailable

from$0.029/ second$0.03310% off

Model IDminimax-h3-max

text-to-videoimage-to-video

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.

Option480p768p1080p
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.

Provider
Video
Estimated cost

Input

prompt
image_url
end_image_url
duration
resolution
aspect_ratio

Result

Idle
Your generation will appear here.

Provider 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.

Source
Scene

14 prompts

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.

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/v1
llms.txt

Quick 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.

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/json
Get an API key

Input

Send JSON with Content-Type: application/json. Model parameters belong inside input; model, provider and callback_url are top-level fields.

Request body

NameTypeRequiredDescription
modelstringYes"minimax-h3-max"
providerstringNoPin a provider; omit to auto-route to the cheapest. One of: fal | 01router | apimart | evolink | atlascloud | vercel
inputobjectYesModel parameters, see the input fields below.
callback_urlstringNoOptional 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.

NameTypeRequiredValuesDefault
prompt*stringYes——
image_url
Optional start image (image-to-video)
stringNo——
end_image_urlstringNo——
durationintegerNomin: 5 · max: 155
resolutionstringNo480p | 768p | 1080p768p
aspect_ratiostringNo16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:916:9
Callbacks →

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.

queued→processing→succeeded / failed

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

NameTypeRequiredDescription
idstringYesGeneration ID. Use it to query or cancel this task.
objectstringYesgeneration
modelstringYesminimax-h3-max
typestringYesvideo
providerstringYesProvider
statusstringYesqueued → processing → succeeded / failed. Stop polling at either terminal state.
inputobjectYesModel parameters, see the input fields below.
outputsstring[]YesResult URLs. Empty while processing; read after succeeded and save the files promptly.
errorstring | nullYesFailure reason, or null when no failure is reported.
creditsnumberYesCredits charged for this request.
price_usdnumberYesRequest price in USD.
created_atstringYesCreation time in ISO 8601 format.
completed_atstring | nullYesCompletion 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"
  }
}
JSON

Model 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)

Auth, routing, billing and error codes are covered in →

Use with AI

Give your coding assistant this model reference: endpoints, input constraints, output fields and request examples in plain text.

Open llms.txt

How does MiniMax H3 Max compare?

Specs and starting prices side by side. Test with the same prompt before you choose.

MiniMax H3 MaxMiniMax H3Grok Imagine Video 1.5Seedance 2.5
VendorMiniMaxMiniMaxxAIByteDance
Starting price$0.029 / second$0.036 / second$0.011 / second$0.086 / second
InputText · ImageText · ImageText · ImageText · Image
Provider6 providers7 providers10 providers9 providers
Duration (s)5 – 155 – 151 – 154 – 30
Resolution480p · 768p · 1080p768p · 2k480p · 720p · 1080p480p · 720p · 1080p
Aspect ratio16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:916:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:916:9 · 4:3 · 3:2 · 1:1 · 2:3 · 3:4 · 9:1616: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.