Hailuo API Generate Video

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

Pricing

Hailuo v2.3

Price (USD)	duration	resolution
$0.23	6	768
$0.45	10	768
$0.4	6	1080

Hailuo v2.3-fast

Price (USD)	duration	resolution
$0.16	6	768
$0.26	10	768
$0.26	6	1080

Model Requirements

Required fields: prompt

Optional fields: image_url, expand_prompt, duration, resolution

Input Constraints

Text Prompt (`prompt`)

Maximum length: 2000 characters

Image Requirements (`image_url`)

File formats: JPG, PNG only

Size limit: 20MB maximum

Dimensions:

Minimum: 300px (width or height)

Maximum: 4096px (width or height)

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

Hailuo v2.3

Duration: 6, 10

Resolution: 768, 1080

1080p+10s is not supported

Configuration Options

Service Mode

Currently only supports "public" mode (aka. PPU)

Important Notes

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 20MB 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 v2.3hailuo v2.3-fast

{
    "model": "hailuo",
    "task_type": "video_generation",
    "input": {
        "prompt": "autumn wind",
        "model": "v2.3",
        "expand_prompt": true,
        "duration": 6,
        "resolution": 768
    },
    "config": {
        "service_mode": "public",
        "webhook_config": {
            "endpoint": "https://webhook.site/7b206bbd-089a-4c96-9cf7-5927c91bfcca",
            "secret": ""
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful response

Body

Example

{
    "timestamp": 1769349220,
    "data": {
        "task_id": "4d5fe927-66ca-4614-ad53-73430dd1f965",
        "model": "hailuo",
        "task_type": "video_generation",
        "status": "completed",
        "config": {
            "service_mode": "public",
            "webhook_config": {
                "endpoint": "https://webhook.site/7b206bbd-089a-4c96-9cf7-5927c91bfcca",
                "secret": ""
            }
        },
        "input": {
            "duration": 6,
            "expand_prompt": true,
            "image_url": "",
            "model": "v2.3",
            "prompt": "autumn wind",
            "resolution": 768
        },
        "output": {
            "video": "https://img.theapi.app/ephemeral/d9cb24bc-3166-41bc-9fe0-7cd7c9942b27.mp4"
        },
        "meta": {
            "created_at": "2026-01-25T13:52:23.125177638Z",
            "started_at": "2026-01-25T13:52:24.247634887Z",
            "ended_at": "2026-01-25T13:53:40.726939834Z",
            "usage": {
                "type": "llm",
                "frozen": 0,
                "consume": 2300000
            },
            "is_using_private_pool": false
        },
        "detail": null,
        "logs": [],
        "error": {
            "code": 0,
            "raw_message": "",
            "message": "",
            "detail": null
        }
    }
}

Generate Video

Pricing#

Hailuo v2.3#

Hailuo v2.3-fast#

Model Requirements#

Input Constraints#

Text Prompt (prompt)#

Image Requirements (image_url)#

Hailuo v2.3#

Configuration Options#

Service Mode#

Important Notes#

Request

Request Code Samples

Responses

Pricing

Hailuo v2.3

Hailuo v2.3-fast

Model Requirements

Input Constraints

Text Prompt (`prompt`)

Image Requirements (`image_url`)

Hailuo v2.3

Configuration Options

Service Mode

Important Notes