Hailuo 2.3

Overview

Hailuo 2.3 is MiniMax’s high-fidelity AI video generation model designed to create realistic motion, expressive characters, and cinematic visuals. It supports both text-to-video and image-to-video, handling complex movements, lighting changes, and detailed facial expressions with stability and consistency.


Test API KEY: key_00000000000000000000000000000000

Endpoints

1. Create Task

Request


POST https://api.pixwith.ai/api/task/create

Headers

Header	Value	Required
Content-Type	application/json	Yes
Api-Key	{API_KEY}	Yes

Request Parameters

Parameter	Type	Required	Description
prompt	string	Yes	The input prompt (e.g., “A cinematic drone shot of snowy mountains at sunrise”)
image_urls	array	Yes	Provide exactly 1 image URL.
model_id	string	Yes	`3-17` (Hailuo 2.3 Standard), `3-18` (Hailuo 2.3 Pro)
options	object	Yes	Configuration options for the task
options.prompt_optimization	boolean	Yes	Auto-translate prompt to English for improved results.
options.resolution	string	Yes	Only `'768p'` is supported.
options.duration	int	Yes	Valid values: `6` or `10` seconds.

Example Request – Standard (Single Image to Video)


{
  "prompt": "Transform this still into a sweeping establishing shot",
  "image_urls": [
    "https://cdn.pixwith.ai/images/example_start.jpeg"
  ],
  "model_id": "3-17",
  "options": {
    "prompt_optimization": true,
    "resolution": "768p",
    "duration": 10
  }
}

Response Parameters

Parameter	Type	Description
code	int	`1` = success, `0` = error
message	string	Success or error message
data	object	Response payload
data.task_id	string	Unique task identifier
data.estimated_time	int	Estimated processing time in seconds (≈180s for 6s clips; 10s clips require ~20% more time).

Response


{
  "code": 1,
  "message": "success",
  "data": {
    "task_id": "d425ab4dc256f0ebaa84862b9cea8a3d",
    "estimated_time": 180
  }
}