hailuo-2.3/i2v-standard

POST

/openapi/v2/minimax/hailuo-2.3/i2v-standard

MiniMax’s premier image-to-video model, crafted to animate static images into seamless cinematic clips. It merges natural motion synthesis with high physical realism, bringing still visuals to life with precision. The model excels in cinematic camera moves like panning and zooming while realistically simulating dynamics such as wind and light reflections. By strictly preserving the original composition, lighting, and character details, it ensures structural consistency throughout the animation. Offering flexible 6- or 10-second durations, it delivers professional-grade fidelity ideal for storytelling, advertising, and high-end product demonstrations.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "prompt": "A cinematic close-up shot focusing on the character's face. The character performs subtle micro-expressions, including a slow blink and a gentle, knowing smile. Realistic light reflects off their eyes and skin texture, shifting organically as the camera performs a very slow, stable push-in. High fidelity, consistent character identity, and seamless motion without flickering.",
    "enablePromptExpansion": true,
    "imageUrl": "https://www.runninghub.cn/view?filename=4d61f88ec47af21bde31c1a4e0414561b2ba4e5e5efe6a36a20a3fe47f82a541.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NjkxNTY4ODA4NzksInRzIjoxNzY4NTUyMDgwODc5LCJzaWduIjoiY2IwMzA3ZTEyMmNkNTRlZDIxNmQwOGEzZmNmZWQ4MzAifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.8176779108089935",
    "duration": "6"
}

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/i2v-standard' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "A cinematic close-up shot focusing on the character'\''s face. The character performs subtle micro-expressions, including a slow blink and a gentle, knowing smile. Realistic light reflects off their eyes and skin texture, shifting organically as the camera performs a very slow, stable push-in. High fidelity, consistent character identity, and seamless motion without flickering.",
    "enablePromptExpansion": true,
    "imageUrl": "https://www.runninghub.cn/view?filename=4d61f88ec47af21bde31c1a4e0414561b2ba4e5e5efe6a36a20a3fe47f82a541.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NjkxNTY4ODA4NzksInRzIjoxNzY4NTUyMDgwODc5LCJzaWduIjoiY2IwMzA3ZTEyMmNkNTRlZDIxNmQwOGEzZmNmZWQ4MzAifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.8176779108089935",
    "duration": "6"
}'

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-02-standard

hailuo-2.3-fast/image-to-video