Hailuo 2.3 - Text to Video

minimax_hailuo_23_t2v

Hailuo 2.3 Text to Video generates high-quality animated video from text prompts with improved resolution and motion quality.

Endpoints

POST /v1/queue/minimax_hailuo_23_t2v # Create task

GET /v1/queue/minimax_hailuo_23_t2v/requests/{request_id}/status # Check status

GET /v1/queue/minimax_hailuo_23_t2v/requests/{request_id}/response # Get result

PUT /v1/queue/minimax_hailuo_23_t2v/requests/{request_id}/cancel # Cancel task

Request parameters

curl --location "https://cloud.seaart.ai/model/v1/queue/minimax_hailuo_23_t2v" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A red apple slowly rotating on a white table, clean studio lighting, static camera.",
    "duration": 6,
    "resolution": "768P"
  }'

prompt string required

Text description for the video. Camera-control instructions can be added with [instruction] syntax for precise camera movement control.

Supported instructions: [左移], [右移], [左摇], [右摇], [推进], [拉远], [上升], [下降], [上摇], [下摇], [变焦推近], [变焦拉远], [晃动], [跟随], [固定]

Combined camera moves in the same [] take effect together, for example [左摇,上升]. Use at most 3 combined instructions.

Sequential camera moves written later in the prompt take effect in order, for example [推进] followed by [拉远].

Maximum length: 2000 characters

duration int

Video duration in seconds.

768P: 6 or 10

1080P: 6

Options: 6, 10

Default: 6

resolution string

Video resolution. 6s supports 768P and 1080P; 10s supports 768P.

Options: 768P, 1080P

Default: 768P

prompt_optimizer bool

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

Default: true

fast_pretreatment bool

Whether to reduce prompt_optimizer optimization latency.

Default: false

aigc_watermark bool

Whether to add a watermark to the generated video.

Default: false

Response parameters

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://cloud.seaart.ai/model/v1/queue/minimax_hailuo_23_t2v/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/minimax_hailuo_23_t2v/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/minimax_hailuo_23_t2v/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Field	Type	Description
`request_id`	string	Task ID used for all follow-up operations.
`response_url`	string	URL to fetch the final result.
`status_url`	string	URL to query task status.
`cancel_url`	string	URL to cancel the task.
`queue_position`	int	Current queue position.

Follow-up operations

Check status

Get result

Cancel task

Error handling