Skip to main content
POST

Authorization

Authorization
string
required
All API endpoints require Bearer Token authenticationGet your API Key:Visit the API Key Management Page to get your API KeyAdd to the request header:

Request Parameters

model
string
required
Supported models:
  • MiniMax-Hailuo-2.3 - Hailuo 2.3
  • MiniMax-Hailuo-2.3-Fast - Hailuo 2.3 Fast (lower latency)
MiniMax-Hailuo-2.3-Fast:
With this model, first_frame_image is required.
prompt
string
required
Video content description (max 2000 characters)Describe scenes, actions, styles in detail for better generation results. Supports camera movement commands (see Camera Movement Commands below).Example: "A cute kitten running on the grass"
duration
integer
default:"6"
Video duration (seconds)Options:
  • 6 - 6-second video
  • 10 - 10-second video
Default: 6
1080p Limitation: When using 1080p resolution, only 6-second duration is supported
resolution
string
default:"768p"
Video resolutionOptions:
  • 768p - High definition
  • 1080p - Full HD (only supports 6-second duration)
Default: 768p
first_frame_image
string
First frame image for the videoSupports two formats:
  • Public URL: https://example.com/start.jpg
  • Base64 encoded: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
When provided, this image will be used as the starting frame of the video
MiniMax-Hailuo-2.3-Fast:
With this model, first_frame_image is required.
prompt_optimizer
boolean
default:"true"
Whether to auto-optimize the promptWhen enabled, the system will automatically optimize your prompt for better generation resultsDefault: true
fast_pretreatment
boolean
default:"false"
Whether to shorten prompt optimization timeWhen enabled, processing speed is faster but optimization quality may be slightly affectedDefault: false
watermark
boolean
default:"false"
Whether to add watermarkDefault: false

Resolution and Duration Combinations

Camera Movement Commands

Use [command] syntax in the prompt to control camera movements. The command labels must be entered exactly as the Chinese labels shown below. 15 commands are supported: Usage example:

Response

code
integer
Response status code, 200 on success
data
array
Response data array

Use Cases

Case 1: Quick Text-to-Video

Case 2: High-Quality 1080p Video

Case 3: Image-to-Video with First Frame

Case 4: Camera Movement Commands

Case 5: Fast Pretreatment Mode

Query Task ResultsVideo generation is an async task that returns a task_id upon submission. Use the Get Task Status endpoint to query generation progress and results.