Submit Video Request

Request

Body Params application/json

model

string

required

Support: MiniMax-Hailuo-02

prompt

string

required

Description of the video.
Note: It should be less than 2000 characters.

first_frame_image

string

optional

The model will use the image passed in this parameter as the first frame to generate a video.
Supported formats:

URL of the image

base64 encoding of the image
Upon passing this parameter, the model is capable of proceeding without a prompt, autonomously determining the progression of the video.
Image specifications:

format must be JPG, JPEG, or PNG;

aspect ratio should be greater than 2:5 and less than 5:2;

the shorter side must exceed 300 pixels;

file size must not exceed 20MB.

prompt_optimizer

boolean

optional

Default value:True. The model will automatically optimize the incoming prompt to improve the generation quality If necessary.
For more precise control, this parameter can be set to
False, and the model will follow the instructions more strictly. At this time
It is recommended to provide finer prompts for best results.

duration

integer

optional

Video length, unit: s (seconds)
Enum values: 6，10

resolution

string

optional

MiniMax-Hailuo-02
6s : default 768P, available: 768P，1080P;
10s：default 768P, available: 768P.

Example

{
    "model": "MiniMax-Hailuo-02",
    "first_frame_image": "https://p2.a.kwimgs.com/bs2/upload-ylab-stunt/ai_portal/1731125871/6N0QrAnAeU/409-f054fa25c21a.png",
    "prompt": "A 20-year-old girl, with an oval face, delicate features, long black hair, fair skin, and ambient light, wearing a short white skirt, sitting on a bench beside the street, smiling and shaking her hair",
    "prompt_optimizer": true,
    "duration": 10,
    "resolution": "768P"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/hailuo/v1/video_generation' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "MiniMax-Hailuo-02",
    "first_frame_image": "https://p2.a.kwimgs.com/bs2/upload-ylab-stunt/ai_portal/1731125871/6N0QrAnAeU/409-f054fa25c21a.png",
    "prompt": "A 20-year-old girl, with an oval face, delicate features, long black hair, fair skin, and ambient light, wearing a short white skirt, sitting on a bench beside the street, smiling and shaking her hair",
    "prompt_optimizer": true,
    "duration": 10,
    "resolution": "768P"
}'

Responses

🟢200OK

application/json

Body

base_resp

object

required

status_code

integer

required

status_msg

string

required

message

string

required

status

string

required

task_id

string

required

Example

{
    "base_resp": {
        "status_code": 0,
        "status_msg": "success"
    },
    "message": "YEScale - Hailuo Video Task Submitted",
    "status": "SUBMITTED",
    "task_id": "9b1f7a8e-1527-4049-a798-ad609835e5a1"
}