Skip to main content
POST
Video Generation

Authorizations

Authorization
string
header
required

HTTP: Bearer Auth

Headers

Content-Type
enum<string>
default:application/json
required

The media type of the request body. Must be set to application/json to ensure the data is sent in JSON format.

Available options:
application/json

Body

application/json
model
enum<string>
required

Model name. Supported values: MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live, I2V-01.

Available options:
MiniMax-Hailuo-2.3,
MiniMax-Hailuo-2.3-Fast,
MiniMax-Hailuo-02,
I2V-01-Director,
I2V-01-live,
I2V-01
first_frame_image
string
required

Specify an image as the starting frame of the video. Supports public URLs or Base64-encoded Data URLs (data:image/jpeg;base64,...).

  • Image requirements:
    • Formats: JPG, JPEG, PNG, WebP
    • Size: Less than 20MB
    • Dimensions: Short edge > 300px; aspect ratio between 2:5 and 5:2
prompt
string

Text description of the video, up to 2000 characters. For MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02 and I2V-01-Director models, camera movement can be controlled using [command] syntax.

  • Supported 15 camera commands:

    • Truck: [Truck left], [Truck right]
    • Pan: [Pan left], [Pan right]
    • Push: [Push in], [Pull out]
    • Pedestal: [Pedestal up], [Pedestal down]
    • Tilt: [Tilt up], [Tilt down]
    • Zoom: [Zoom in], [Zoom out]
    • Shake: [Shake]
    • Follow: [Tracking shot]
    • Static: [Static shot]
  • Usage rules:

    • Combined movements: Multiple commands inside one [] take effect simultaneously (e.g., [Pan left,Pedestal up]). Recommended max: 3.
    • Sequential movements: Commands appear in order, e.g., "...[Push in], then...[Push out]".
    • Natural language: Free-form descriptions also work, but explicit commands yield more accurate results.
prompt_optimizer
boolean

Whether to automatically optimize the prompt. Defaults to true. Set to false for more precise control.

fast_pretreatment
boolean

Reduces optimization time when prompt_optimizer is enabled. Defaults to false. Applies only to MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-Fast and MiniMax-Hailuo-02.

duration
integer

Video duration (seconds). Default is 6. Supported values depend on the model and resolution:

Notes: The default resolution for other models is 720p.

resolution
enum<string>

Video resolution. Options depend on model and duration:

Available options:
512P,
720P,
768P,
1080P
callback_url
string

A callback URL to receive asynchronous task status updates.

  1. Validation: Once configured, MiniMax sends a POST request with a challenge field. Your server must echo this value within 3s to validate.
  2. Updates: After validation, MiniMax pushes status updates when the task changes. Response structure matches the Query Video Generation Task API.

Callback status values:

  • "processing" – Task in progress
  • "success" – Task completed successfully
  • "failed" – Task failed

Response

200 - application/json
task_id
string

The video generation task ID, used for querying status.

base_resp
object