Hailuo API Generate Video

Hailuo API provides video generation services with various models supporting text-to-video and image-to-video conversions.

Pricing

Hailuo v1

Model	Price (USD)	Special Requirements
t2v-01	$0.20	None
i2v-01	$0.20	None
t2v-01-director	$0.20	None
i2v-01-director	$0.20	None
i2v-01-live	$0.20	None
s2v-01	$0.30	Must detect human face in input image

Hailuo v2

Model	Price (USD)	duration	resolution
t2v-02, i2v-02	$0.25	6	768
t2v-02, i2v-02	$0.50	10	768
t2v-02, i2v-02	$0.80	6	1080

Model Requirements

Text-to-Video (t2v-01, t2v-01-director)

Required fields: prompt

Optional fields: expand_prompt

image_url should not be provided

Text-to-Video (t2v-02)

Required fields: prompt

Optional fields: expand_prompt, duration, resolution

image_url should not be provided

Image-to-Video (i2v-01, i2v-01-live, i2v-01-director)

Required fields: image_url

Optional fields: prompt, expand_prompt

Image-to-Video (i2v-02)

Required fields: image_url

Optional fields: prompt, expand_prompt, duration, resolution

Subject Reference Video (s2v-01)

Required fields: prompt, image_url

Optional fields: expand_prompt

Input image must contain detectable human face

Higher pricing tier ($0.30 per generation)

Input Constraints

Text Prompt (`prompt`)

Maximum length: 2000 characters

Required for: t2v-01, s2v-01, i2v-01-director, t2v-01-director

Optional for: i2v-01, i2v-01-live

Image Requirements (`image_url`)

File formats: JPG, PNG only

Size limit: 10MB maximum

Dimensions:

Minimum: 300px (width or height)

Maximum: 4096px (width or height)

Aspect ratio: Must be between 2:5 and 5:2

Required for: i2v-01, i2v-01-live, s2v-01, i2v-01-director

Hailuo v2

Duration: 6, 10

Resolution: 768, 1080

1080p+10s is not supported

Configuration Options

Service Mode

Currently only supports "public" mode (or Pay-As-You-Go)

Important Notes

For s2v-01 model:

Face detection is mandatory in the input image

Failed face detection will result in task failure

Higher price (

0.30 v s

0.20 for other models)

Image processing:

All dimensions must be within 300px to 4096px range

Aspect ratio must be between 2:5 and 5:2

Only JPG and PNG formats are accepted

Images larger than 10MB will be rejected

Billing:

Cost is calculated per generation

Charges are applied upon successful task completion only

Request

Header Params

Body Params application/json

Examples

hailuo v1hailuo v2

{
    "model": "hailuo",
    "task_type": "video_generation",
    "input": {
        "prompt": "autumn wind, wild",
        "model": "t2v-01",
        "expand_prompt": true
    },
    "config": {
        "service_mode": "public",
        "webhook_config": {
            "endpoint": "https://webhook.site/e20b246e-07f9-4f04-aa70-07d8d1042b1b",
            "secret": "123456"
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful response

Body

Example

{
    "code": 200,
    "data": {
        "task_id": "3f6d4641-afe2-4386-b6cf-d3f90133e2e7",
        "model": "hailuo",
        "task_type": "video_generation",
        "status": "pending",
        "config": {
            "service_mode": "",
            "webhook_config": {
                "endpoint": "https://webhook.site/1a45ac8c-fcf7-4b32-8fee-94eecc073d77",
                "secret": "123456"
            }
        },
        "input": {
            "expand_prompt": true,
            "model": "t2v-01",
            "prompt": "autumn wind, wild"
        },
        "output": {
            "percent": 0,
            "cover_url": "",
            "video_url": "",
            "download_url": "",
            "desc": "",
            "prompt_img_url": "",
            "status": 0,
            "user_origin_prompt": false,
            "width": 0,
            "height": 0,
            "model_id": "",
            "message": ""
        },
        "meta": {
            "created_at": "2025-08-22T07:54:16.579786508Z",
            "started_at": "0001-01-01T00:00:00Z",
            "ended_at": "0001-01-01T00:00:00Z",
            "usage": {
                "type": "point",
                "frozen": 2000000,
                "consume": 0
            },
            "is_using_private_pool": false
        },
        "detail": null,
        "logs": null,
        "error": {
            "code": 0,
            "raw_message": "",
            "message": "",
            "detail": null
        }
    },
    "message": "success"
}

Generate Video

Pricing#

Hailuo v1#

Hailuo v2#

Model Requirements#

Text-to-Video (t2v-01, t2v-01-director)#

Text-to-Video (t2v-02)#

Image-to-Video (i2v-01, i2v-01-live, i2v-01-director)#

Image-to-Video (i2v-02)#

Subject Reference Video (s2v-01)#

Input Constraints#

Text Prompt (prompt)#

Image Requirements (image_url)#

Hailuo v2#

Configuration Options#

Service Mode#

Important Notes#

Request

Request Code Samples

Responses

Pricing

Hailuo v1

Hailuo v2

Model Requirements

Text-to-Video (t2v-01, t2v-01-director)

Text-to-Video (t2v-02)

Image-to-Video (i2v-01, i2v-01-live, i2v-01-director)

Image-to-Video (i2v-02)

Subject Reference Video (s2v-01)

Input Constraints

Text Prompt (`prompt`)

Image Requirements (`image_url`)

Hailuo v2

Configuration Options

Service Mode

Important Notes