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 samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful response

Body

Example

{
    "code": 200,
    "message": "string",
    "data": {
        "task_id": "736fde4d-9029-4915-8189-01353d6982cb",
        "model": "string",
        "task_type": "string",
        "status": "string",
        "config": {},
        "input": {},
        "output": {
            "percent": 0,
            "cover_url": "http://example.com",
            "video_url": "http://example.com",
            "download_url": "http://example.com",
            "desc": "string",
            "prompt_img_url": "string",
            "status": 0,
            "user_origin_prompt": true,
            "width": 0,
            "height": 0,
            "model_id": "string",
            "message": "string"
        },
        "meta": {
            "created_at": "2019-08-24T14:15:22Z",
            "started_at": "2019-08-24T14:15:22Z",
            "ended_at": "2019-08-24T14:15:22Z",
            "usage": {
                "type": "string",
                "frozen": 0,
                "consume": 0
            },
            "is_using_private_pool": true
        },
        "error": {
            "code": 0,
            "raw_message": "string",
            "message": "string",
            "detail": {}
        }
    }
}

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 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