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-02, T2V-01-Director, T2V-01.

Available options:
MiniMax-Hailuo-2.3,
MiniMax-Hailuo-02,
T2V-01-Director,
T2V-01
prompt
string
required

Text description of the video, up to 2000 characters.
For MiniMax-Hailuo-2.3, MiniMax-Hailuo-02 and T2V-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 and MiniMax-Hailuo-02.

duration
integer

Video length (seconds). Default is 6. Available values depend on model and resolution:

resolution
enum<string>

Video resolution. Options depend on model and duration:

Available options:
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