Hailuo 2 & API
Generate text-to-video, image-to-video, and subject-reference videos through PiAPI with Hailuo v2.3, Hailuo v2.3-fast, API docs, pricing, and free credits for new users.
Hailuo 2 API Pricing
Pay-as-you-go access through PiAPI.
Hailuo v2.3 FastFast
$0.16-$0.26
- 768p or 1080p output
- 6- or 10-second video options
Hailuo v2.3
$0.23-$0.45
- Text-to-video and image-to-video
- Higher-quality 768p or 1080p output
Features
Capabilities from the production model page.
Text to Video (T2V-01)
Simply enter your text prompts and stunning videos will be generated by Hailuo AI! Try through our Playground or through the Hailuo API!
Image to Video (I2V)
Want to generate videos based on your images? Drag and drop your image along with a textual prompt and see I2V-01 (and I2V-01-live) in action!
Subject Reference (S2V)
Upload a reference image and describe your scene, and get ready to be amazed with revolutionizing character consistency!
Recreate Function Supported
Like a specific clip generated and want to try again with a different spin? We support Hailuo's recreate feature through the API endpoint.
Bulk Generation Available
Looking to perform a large amount of text-to-video generation tasks for your own site or your own database? Contact us on Discord with your prompts and we will get back to you as soon as possible!
Dual API Service Modes
Host-your-own-account mode and Pay-as-you-go mode are both supported for Hailuo API. Choose the best approach for your development needs or even mix and them both for stability and cost.
Asynchronous API Calls
Our asynchronous functionality allows users to submit tasks while their program continues to run without interruption until the callback function is triggered.
Watermark Removal
By subscribing to PiAPI's Premium Subscription Plan, users will be able to remove the "Hailuo" watermark on the bottom right corner of the generated video.
Priority Generations
With PiAPI's Premium Subscription Plan, users benefit from top-priority generations, making it perfect for peak load and high demand periods!
Commercial Use
Subscribers to the Premium Plan are allowed to use the generated video outputs for commercial purposes to suit their needs.
Get started
Create your API key
Sign up and grab an API key from the PiAPI workspace — free credits are included on sign-up.
Top up credits
Add credits on the billing page when you are ready to scale beyond the free tier.
Call the API
POST your first task following the API docs, then poll the task until the result is ready.
Iterate in the playground
Prototype prompts and settings in the the playground above before wiring them into your product.
curl -X POST 'https://api.piapi.ai/api/v1/task' \
-H 'X-API-Key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "hailuo",
"task_type": "video_generation",
"input": {
"model": "v2.3",
"prompt": "A playful cat explores a sunlit garden",
"resolution": 768,
"duration": 6,
"expand_prompt": true
}
}'
# → { "task_id": "9d5a…", "status": "pending" }curl 'https://api.piapi.ai/api/v1/task/{task_id}' \
-H 'X-API-Key: YOUR_API_KEY'
# poll until status = completed
{
"data": {
"status": "completed",
"output": {
"video_url": "https://img.theapi.app/ephemeral/…"
}
}
}$ npm install -g piapi-cli $ piapi run hailuo-02 \ model=v2.3 \ prompt="A playful cat explores a sunlit garden" \ resolution=768 \ duration=6 \ expand_prompt=true ✓ Task completed! https://img.theapi.app/ephemeral/…
Frequently asked questions
What is Hailuo AI Video Generator?
What is the Hailuo API?
Hailuo Video API is provided by PiAPI to enable developers to integrate the video generation capability of Hailuo into their own APP!
What type of videos can I make with the Hailuo AI?
You can effortlessly create all sorts of stunning videos with the Hailuo AI Video Generator, transforming your ideas into captivating visuals in just minutes!
What are the current limitations with regarding to video generated?
As good as the current model is now, there are still some limitations. For example, in complex, action-packed scene such as a car drifting on snow-covered roads, object morphing can occur, Occasionally, objects that are supposed to be moving remain static. Accurate text displaying also requires further improvement.
Can you offer the video preview feature during the generation process?
Currently Hailuo does not offer this feature as part of the web application, but when they do, PiAPI will integrate this feature into our supported features.
Can I use videos generated from the Hailuo API for commercial purposes?
PiAPI does not put any restrictions on the usage of the generated video. Please also refer to terms of use from Hailuo for more details.
More questions? See the API docs.
Our blog
Check out our blog for related contents!



