Skip to main content
POST
Hailuo 2.3
Optimized for realistic human motion and cinematic VFX

Authorizations

Authorization
string
header
required

API Key for API endpoints

Body

prompt
string
required

Text prompt for generation

first_frame_url
string
required

First frame image for frames mode

duration
default:6

Duration of the video in seconds. 10 seconds is only available for 768p resolution.

resolution
enum<string>
default:768p

Pick between 768p or 1080p resolution. 1080p supports only 6-second duration.

Available options:
768p,
1080p
prompt_optimizer
boolean
default:true

Use prompt optimizer

n
integer
default:1

Number of results to generate (1-4)

Required range: 1 <= x <= 4

Response

Generation submission accepted

id
string
required

Generation id.

status
enum<string>
required

Queue status

Available options:
IN_QUEUE,
IN_PROGRESS,
COMPLETED,
FAILED,
CANCELED
input
Input · object
required

Normalized input payload for the generation task.

usage
object
required

Credit usage breakdown for the request

code
string

Machine-readable generation error code. Present when status is FAILED.

message
string

Sanitized human-readable failure message. Present when status is FAILED.