Hailuo 2.3 - Image to Video

minimax_hailuo_23_i2v

Hailuo 2.3 Image to Video generates high-quality animated video from images with improved resolution and motion quality.

Endpoints

POST /v1/queue/minimax_hailuo_23_i2v # Create task

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

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

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

Request parameters

curl --location "https://cloud.seaart.ai/model/v1/queue/minimax_hailuo_23_i2v" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "first_frame_image": "https://image.cdn2.seaart.me/2026-06-01/d8ejq1de878c739e2lrg/995ff4fe1eeec10a06c3c7a172862733.webp",
    "prompt": "A red apple slowly rotating on a white table, clean studio lighting, static camera.",
    "duration": 6,
    "resolution": "768P"
  }'

first_frame_image string required

Image used as the first frame of the video. Supports public URLs or Base64 Data URLs such as data:image/jpeg;base64,....

Image formats: JPG, JPEG, PNG, WebP

Image size: less than 20MB

Image dimensions: short side greater than 300px, aspect ratio between 2:5 and 5:2

prompt string

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

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

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_i2v/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/minimax_hailuo_23_i2v/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/minimax_hailuo_23_i2v/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