hailuo-2.3/i2v-pro

POST

/openapi/v2/minimax/hailuo-2.3/image-to-video-pro

Hailuo 2.3 Pro represents the pinnacle of MiniMax’s image-to-video technology, transforming static images into stunning, native 1080p cinematic videos. Designed for professional creators and studios, it features next-generation motion rendering that accurately simulates complex lighting shifts, realistic physics, and organic fabric movements. The model ensures impeccable visual fidelity and stable composition across every frame, delivering film-grade warmth and depth in just 5 seconds. It bridges the gap between still photography and high-end cinematography, offering a seamless and efficient solution for professional-grade digital storytelling.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "prompt": "A professional cinematic tracking shot. The character's flowing silk cloak moves organically with realistic wind physics. Soft amber light shifts across the scene, creating dynamic reflections on metallic surfaces and detailed shadows on the ground. The camera performs a smooth, high-fidelity depth transition from a medium shot to a close-up, focusing on the intricate textures and consistent facial features. All motion is seamless with organic consistency and film-grade color grading.",
    "enablePromptExpansion": true,
    "imageUrl": "https://www.runninghub.cn/view?filename=dcd60f26da39bb0006def1991b065d61dbd537c51a579acaadc083cbeefdf41d.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NjkxNjU1Mzg2MjMsInRzIjoxNzY4NTYwNzM4NjIzLCJzaWduIjoiMTIyNTYyOGY4YTA1MWI5M2MyYTYzZDk0MjNkOWRkMDUifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.938979167635613"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.ai/openapi/v2/minimax/hailuo-2.3/image-to-video-pro' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "A professional cinematic tracking shot. The character'\''s flowing silk cloak moves organically with realistic wind physics. Soft amber light shifts across the scene, creating dynamic reflections on metallic surfaces and detailed shadows on the ground. The camera performs a smooth, high-fidelity depth transition from a medium shot to a close-up, focusing on the intricate textures and consistent facial features. All motion is seamless with organic consistency and film-grade color grading.",
    "enablePromptExpansion": true,
    "imageUrl": "https://www.runninghub.cn/view?filename=dcd60f26da39bb0006def1991b065d61dbd537c51a579acaadc083cbeefdf41d.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NjkxNjU1Mzg2MjMsInRzIjoxNzY4NTYwNzM4NjIzLCJzaWduIjoiMTIyNTYyOGY4YTA1MWI5M2MyYTYzZDk0MjNkOWRkMDUifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.938979167635613"
}'

Responses

🟢200成功

application/json

Task result query endpoint: /openapi/v2/query

Body

Examples

Submit response exampleTask success response example

{
    "taskId": "2013508786110730241",
    "status": "RUNNING",
    "errorCode": "",
    "errorMessage": "",
    "results": null,
    "clientId": "f828b9af25161bc066ef152db7b29ccc",
    "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"4\"], \"node_errors\": {}}"
}

Modified at 2026-03-12 04:00:02

hailuo-2.3-fast-pro/image-to-video

hailuo-02-i2v-pro