MiniMax Hailuo 2.3
MiniMax Hailuo 2.3 is a cinematic video model for short form production. It accepts text prompts or image inputs and outputs 6 or 10 second clips at 768p or 1080p. It focuses on consistent motion, strong physics, and stable scenes for ads, social content, and creative shots.
API Reference
INTEGRATE
Complete technical specification for integration
Request Response
Examples 4
CODE
Ready-to-use code snippets for common workflows
Submerged Grand Piano Ballroom
{
"taskType": "videoInference",
"taskUUID": "12c20a98-991b-459f-b3a3-41741a7dfd19",
"model": "minimax:4@1",
"positivePrompt": "A vast forgotten ballroom fully submerged underwater, a black grand piano resting on a marble floor while translucent curtains sway gently from tall arched windows. Shafts of pale morning light filter through the water, illuminating floating sheet music, tiny bubbles, and suspended dust. Small silver fish weave between chandeliers overhead. The camera begins with a slow wide glide across cracked checkerboard tiles, then eases closer to the piano as a single white glove drifts past the keys. Rich cinematic realism, graceful motion, stable composition, detailed caustics, elegant atmosphere, strong depth, realistic underwater physics, premium short-film look.",
"width": 1920,
"height": 1080,
"duration": 6,
"fps": 25,
"providerSettings": {
"minimax": {
"promptOptimizer": false
}
}
}{
"taskType": "videoInference",
"taskUUID": "12c20a98-991b-459f-b3a3-41741a7dfd19",
"videoUUID": "bfe8f918-e001-4d15-99ed-57b2abf769b5",
"videoURL": "https://vm.runware.ai/video/os/a12d13/ws/5/vi/bfe8f918-e001-4d15-99ed-57b2abf769b5.mp4",
"seed": 552434557,
"cost": 0.49
}Glasshouse Violin Repair Bench
{
"taskType": "videoInference",
"taskUUID": "97375c0b-7fe1-4361-b9c9-dbe56adbb1ea",
"model": "minimax:4@1",
"positivePrompt": "Animate from the provided first frame as a refined cinematic macro-to-medium shot in a sunlit glasshouse workshop. A luthier carefully tightens and tests violin strings with subtle, precise hand motion. The camera performs a gentle slow push-in with slight parallax across tools and wood shavings. Dust motes drift through warm shafts of light, fern leaves sway faintly in the distance, varnish jars catch shifting highlights, and the violin body reflects soft moving glints. Preserve scene layout and subject identity, with stable composition, realistic material response, natural finger articulation, delicate object interaction, and polished short-form commercial quality.",
"width": 1366,
"height": 768,
"duration": 6,
"fps": 25,
"providerSettings": {
"minimax": {
"promptOptimizer": false
}
},
"inputs": {
"frameImages": [
{
"image": "https://assets.runware.ai/assets/inputs/42669300-03ee-4ffc-838b-725c43d380da.jpg",
"frame": "first"
}
]
}
}{
"taskType": "videoInference",
"taskUUID": "97375c0b-7fe1-4361-b9c9-dbe56adbb1ea",
"videoUUID": "18027be8-4589-48cc-bfae-2dd54c39bde2",
"videoURL": "https://vm.runware.ai/video/os/a09d21/ws/5/vi/18027be8-4589-48cc-bfae-2dd54c39bde2.mp4",
"seed": 150814442,
"cost": 0.28
}Windblown Desert Airship Arrival
{
"taskType": "videoInference",
"taskUUID": "55eda37a-26c4-4640-bbf1-28985fdb6713",
"model": "minimax:4@1",
"positivePrompt": "A cinematic wide shot of a colossal copper-and-canvas airship descending toward an isolated desert outpost built from sun-baked stone and faded fabric canopies, late afternoon light casting long amber shadows across rippled dunes. Wind drives sheets of dust around landing pylons as workers in layered travel garments brace ropes and signal from the ground. The airship’s suspension cables sway realistically, sand spirals outward from the downdraft, fabric awnings snap and flutter, small loose objects skid across the ground, and the vessel settles with believable weight and inertia. Camera language: slow forward tracking shot with slight handheld vibration from the gusts, maintaining clear focus on the descending craft and the settlement below. Rich atmospheric depth, dramatic scale, grounded physics, consistent scene continuity, premium short-form commercial cinematography.",
"width": 1920,
"height": 1080,
"duration": 6,
"fps": 25,
"providerSettings": {
"minimax": {
"promptOptimizer": false
}
}
}{
"taskType": "videoInference",
"taskUUID": "55eda37a-26c4-4640-bbf1-28985fdb6713",
"videoUUID": "d44f3345-bd0d-48ef-8636-93f874d4ec80",
"videoURL": "https://vm.runware.ai/video/os/a17d13/ws/5/vi/d44f3345-bd0d-48ef-8636-93f874d4ec80.mp4",
"seed": 291400484,
"cost": 0.49
}Rain-Slick Arcade Alley
{
"taskType": "videoInference",
"taskUUID": "0ca5af1b-1ce8-49ba-9838-8808ac1f9730",
"model": "minimax:4@1",
"positivePrompt": "Using the provided first frame as the opening shot, create a 6-second cinematic sequence in a rain-slick alley beside an old arcade. The teenager in the yellow raincoat gently releases the paper airplane and watches it glide forward through the damp air. The camera makes a subtle slow push-in while keeping the scene composition stable. Steam curls from the street vent, puddles ripple from light drips overhead, reflected signage shimmers across the pavement, and the arcade doorway flickers with soft colored light. Preserve realistic physics, natural fabric motion, wet-surface reflections, restrained atmosphere, and cohesive live-action cinematography with crisp detail and grounded movement.",
"width": 1366,
"height": 768,
"duration": 6,
"fps": 25,
"providerSettings": {
"minimax": {
"promptOptimizer": false
}
},
"inputs": {
"frameImages": [
{
"image": "https://assets.runware.ai/assets/inputs/7cb04824-f18d-44be-83ba-55296f82f30b.jpg",
"frame": "first"
}
]
}
}{
"taskType": "videoInference",
"taskUUID": "0ca5af1b-1ce8-49ba-9838-8808ac1f9730",
"videoUUID": "8e84991e-503c-4208-8540-087361b38255",
"videoURL": "https://vm.runware.ai/video/os/a09d21/ws/5/vi/8e84991e-503c-4208-8540-087361b38255.mp4",
"seed": 441958454,
"cost": 0.28
}