hailuo-02-i2v-pro

POST

/openapi/v2/minimax/hailuo-02/i2v-pro

Hailuo 02 (I2V Pro) represents a milestone in AI video generation, engineered for high-end cinematic realism and physical accuracy. It delivers native 1080P HD output directly from the model, ensuring professional-grade clarity and fine textures across all frames. With enhanced motion dynamics and physics simulation, it captures complex actions and lighting transitions with lifelike precision. Featuring 5-second duration options and intelligent scene transitions, Hailuo 02 ensures seamless continuity and strong prompt adherence. It is the premier choice for creators seeking predictable, high-fidelity results for advertising and cinematic storytelling.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "prompt": "A professional cinematic sequence. From the static reference image, the glowing cosmic particles begin to swirl with realistic fluid dynamics around the character's hand. The camera performs a slow, smooth dolly-zoom, creating a dramatic perspective shift while maintaining perfect texture clarity. Light from the floating crystals reflects realistically on the helmet's surface with dynamic glare. The scene concludes with a seamless transition as the background bioluminescent plants gently sway in a rhythmic motion. High fidelity, consistent character identity, cinematic lighting transitions.",
    "enablePromptExpansion": true,
    "firstImageUrl": "https://www.runninghub.cn/view?filename=63401e097aefaed4a32ca58c5fcb8ee65f895d4eccd41c8c6d7d1000baa862e6.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NjkxNTQ1ODYxMTMsInRzIjoxNzY4NTQ5Nzg2MTEzLCJzaWduIjoiZmU5NjkxOGJmNDAyZmU4MjFiMDIyM2U0MjIxYTgyYWEifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.510696770701816"
}

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-02/i2v-pro' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "A professional cinematic sequence. From the static reference image, the glowing cosmic particles begin to swirl with realistic fluid dynamics around the character'\''s hand. The camera performs a slow, smooth dolly-zoom, creating a dramatic perspective shift while maintaining perfect texture clarity. Light from the floating crystals reflects realistically on the helmet'\''s surface with dynamic glare. The scene concludes with a seamless transition as the background bioluminescent plants gently sway in a rhythmic motion. High fidelity, consistent character identity, cinematic lighting transitions.",
    "enablePromptExpansion": true,
    "firstImageUrl": "https://www.runninghub.cn/view?filename=63401e097aefaed4a32ca58c5fcb8ee65f895d4eccd41c8c6d7d1000baa862e6.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NjkxNTQ1ODYxMTMsInRzIjoxNzY4NTQ5Nzg2MTEzLCJzaWduIjoiZmU5NjkxOGJmNDAyZmU4MjFiMDIyM2U0MjIxYTgyYWEifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.510696770701816"
}'

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/i2v-pro

hailuo-02-fast