Hailuo 02

Overview

Hailuo 2 is a high-quality video generation model that supports both text-to-video and image-to-video modes. This model offers two versions: Hailuo 02 and Hailuo 02 1080p.


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 cat walking in the garden”)
image_urls	array	Conditional	[“https://cdn.pixwith.ai/xxx.jpg ”]. Provide 1 image.
model_id	string	Yes	`2-3`(Hailuo 02), `2-16`(Hailuo 02 1080p)
options	object	Yes	Configuration options for the task
options.prompt_optimization	boolean	Yes	If true, all prompt words will be automatically translated into English.
options.resolution	string	Required	Resolution of the output. For model_id `2-3`(Hailuo 02 with image): `'512p'`,`768p'`, For model_id `2-3` （Hailuo 02 without image）: `768p`(only). For model_id `2-16`(Hailuo 02 1080p): `'1080p'`
options.duration	int	Required	Duration in seconds. For model_id `2-3`(Hailuo 02): `6` or `10`. For model_id `2-16`(Hailuo 02 1080p): `6`

Example Request - Hailuo 02 (Text-to-Video)


{
  "prompt": "A cat walking in the garden",
  "model_id": "2-3",
  "options": {
    "prompt_optimization": true,
    "resolution": "768p",
    "duration": 6
  }
}

Example Request - Hailuo 02 (Image-to-Video)


{
  "prompt": "A cat walking in the garden",
  "image_urls": [
    "https://cdn.pixwith.ai/images/cf0ddb5ad6a0f0c85ab4d1dceb9fd89c_0.jpeg"
  ],
  "model_id": "2-3",
  "options": {
    "prompt_optimization": true,
    "resolution": "512p",
    "duration": 6
  }
}

Example Request - Hailuo 02 1080p


{
  "prompt": "A cat walking in the garden",
  "model_id": "2-16",
  "options": {
    "prompt_optimization": true,
    "resolution": "1080p",
    "duration": 6
  }
}

Response Parameters

Parameter	Type	Description
code	int	1=success, 0=error
message	string	Success and failure messages
data	object
data.task_id	string
data.estimated_time	int	Estimated time in seconds

Response


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