⌘K

Hailuo 2.3 - Text to Video

minimax_hailuo_23_t2v

Hailuo 2.3 T2V generates high-quality animated videos from text prompts with enhanced resolution and motion quality.

Authentication

authorization string required

All APIs require authentication via Bearer Token.

Get API Key:

Visit API Key Management Page to get your API Key.

Usage:

Add to request header:

Authorization: Bearer YOUR_API_KEY

Parameters

model string required

Model ID to use for the request

Options: minimax_hailuo_23_t2v

prompt string required

Text description for video generation, maximum 2000 characters

Supports camera movement control using [instruction] syntax. You can add camera instructions in the prompt using the [instruction] format for precise camera control.

Supported 15 camera instructions:
Pan: [pan left], [pan right]
Tilt: [tilt left], [tilt right]
Push/Pull: [push in], [pull back]
Rise/Lower: [rise], [lower]
Up/Down tilt: [tilt up], [tilt down]
Zoom: [zoom in], [zoom out]
Other: [shake], [follow], [static]

Usage rules:
Combined movements: Multiple instructions within the same [] will take effect simultaneously, e.g. [tilt left, rise], recommend no more than 3 combined instructions
Sequential movements: Instructions appearing before and after in the prompt will take effect in sequence, e.g. ”…[push in], then…[pull back]“
Natural language: Camera movements can also be described in natural language, but using standard instructions provides more accurate responses

prompt_optimizer boolean

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

Default: true

fast_pretreatment boolean

Whether to shorten the optimization time of prompt_optimizer

Default: false

duration integer

Video duration in seconds

768P: 6 or 10
1080P: 6

Options: 6, 10

Default: 6

resolution string

Video resolution

6s: 768P (default), 1080P
10s: 768P (default)

Options: 768P, 1080P

Default: 768P

callback_url string

Callback URL for receiving task status update notifications. Supports configuring callbacks via the callback_url parameter to receive asynchronous notifications of task status updates

aigc_watermark boolean

Whether to add watermark to the generated video

Default: false

Polling

Since result generation takes time, you need to poll the task status after creating the task.

The initial response only returns information such as the task ID and initial status. The final result must be obtained by polling the task status endpoint using the task ID.

See the examples on the right for polling requests and responses.

Response Format

error object

Error information, only present when status is failed

code string

Error code

message string

Detailed error message

output array

Generation results, only present when status is completed

content array

List of generated resource content

type string

Resource type

Value: image｜video

url string

Processed resource URL

jobId string

Remote task ID

usage object

Usage statistics, only present when status is completed

cost string

Total cost in USD

discount number

Discount amount

metadata object

Metadata information