Skip to main content
POST

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

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.
boolean
default:"false"
Whether to run content moderation before submitting the video task.
  • true: use omni-moderation-latest to review prompts and input images
  • false or omitted: do not send a moderation request, adding no moderation cost or latency (default)
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"
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
string
default:"768p"
Video resolutionOptions:
  • 768p - High definition
  • 1080p - Full HD (only supports 6-second duration)
Default: 768p
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.
boolean
default:"true"
Whether to auto-optimize the promptWhen enabled, the system will automatically optimize your prompt for better generation resultsDefault: true
boolean
default:"false"
Whether to shorten prompt optimization timeWhen enabled, processing speed is faster but optimization quality may be slightly affectedDefault: false
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

integer
Response status code, 200 on success
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.