Readme
Hailuo AI 02: Professional Text-to-Video Generation
Transform your creative vision into stunning video content with Hailuo AI 02, a state-of-the-art text-to-video generation model optimized for professional content creators and developers.
Overview
Hailuo AI 02 converts text descriptions into high-quality video clips, offering unparalleled control over video generation. Whether you're creating social media content, marketing materials, or prototyping video concepts, Hailuo delivers professional results with minimal effort.
Key Capabilities:
- Generate videos up to 10 seconds at 1080p resolution
- Control camera movements with director-level commands
- Industry-leading physics simulation and motion consistency
- Fast generation times (approximately 8 minutes)
- Seamless API integration with popular development frameworks
Getting Started
Setting up Hailuo AI 02 takes just a few minutes. Here's how to begin:
- Install the client library:
npm install --save @fal-ai/client
# or
pip install fal-client
- Configure your authentication:
import { fal } from "@fal-ai/client";
fal.config({
credentials: "YOUR_FAL_KEY_HERE"
});
- Make your first API call:
const result = await fal.subscribe("fal-ai/minimax/hailuo-02/pro/text-to-video", {
input: {
prompt: "A serene mountain landscape with clouds rolling over peaks at sunset"
}
});
Advanced Usage
The model accepts several parameters to fine-tune your video output:
const result = await fal.subscribe("fal-ai/minimax/hailuo-02/pro/text-to-video", {
input: {
prompt: "Your detailed prompt with [camera movements]",
prompt_optimizer: true,
first_frame_image: "https://your-image-url.jpg",
duration: 6, // or 10 seconds
resolution: "1080P" // or "768P"
}
});
Camera Movement Instructions
Add professional camera movements using square brackets in your prompt:
[Pan left/right][Truck left/right][Push in/Pull out][Pedestal up/down][Tilt up/down][Zoom in/out][Shake][Tracking shot][Static shot]
You can combine up to 3 movements per prompt, e.g., [Truck left, Pan right, Zoom in].
Queue-Based Processing
For handling asynchronous generation:
// Submit request
const { request_id } = await fal.queue.submit("fal-ai/minimax/hailuo-02/pro/text-to-video", {
input: {
prompt: "Your prompt"
},
webhookUrl: "https://optional.webhook.url/for/results"
});
// Check status
const status = await fal.queue.status("fal-ai/minimax/hailuo-02/pro/text-to-video", {
requestId: request_id,
logs: true
});
// Get result
const result = await fal.queue.result("fal-ai/minimax/hailuo-02/pro/text-to-video", {
requestId: request_id
});
Technical Specifications
Performance Metrics:
- Generation time: Approximately 8 minutes for Pro version
- Output resolution: 768P or 1080P (Pro)
- Frame rate: 25 fps
- Video duration: 6 or 10 seconds
- Model ranking: #2 globally on Artificial Analysis benchmark
Input Requirements:
- Text prompts: Detailed descriptions with optional camera movements
- First frame image (optional): JPG, JPEG, or PNG format
- Image specifications: Aspect ratio between 2:5 and 5:2, minimum 300px on shorter side, max 20MB
Best Practices
For optimal results when using Hailuo AI 02:
- Write detailed, specific prompts that describe both visual elements and motion
- Use the
prompt_optimizer feature for improved generation quality
- When using
first_frame_image, ensure it matches your prompt description
- Monitor API response times and implement appropriate error handling
- Use director camera commands for cinematic control
Error Handling and Troubleshooting
Implement robust error handling in your applications:
try {
const result = await fal.subscribe("fal-ai/minimax/hailuo-02/pro/text-to-video", {
input: { prompt: "Your prompt" }
});
} catch (error) {
console.error("Video generation failed:", error.message);
// Implement appropriate fallback behavior
}
Pricing and Usage
- Pro version (1080p): $0.08 per second of video generated
- Standard version (768p): $0.045 per second of video generated
- Example: A 6-second Pro video costs $0.48
Our transparent, usage-based pricing scales with your needs:
- No subscription necessary
- Pay only for what you generate
- No hidden fees or minimum commitments
View detailed pricing or contact sales for enterprise solutions.
Available Models
MiniMax offers multiple video generation models:
- Hailuo-02 Pro: 1080p resolution, advanced features
- Hailuo-02 Standard: 768p resolution, faster processing
- Video-01: Previous generation model
- Image-to-Video variants: For animating static images
Use Cases
Hailuo AI 02 excels in various professional applications:
Marketing and Advertising
- Create engaging social media content and ad creative quickly
- Prototype video concepts before full production
- Generate product demonstrations and tutorials
Content Creation
- Develop unique video backgrounds and transitions
- Create animated elements for streaming content
- Generate B-roll footage on demand
Education and Training
- Produce educational video content
- Create visual explanations of complex concepts
- Generate custom training materials
Support and Resources
We're here to help you succeed with Hailuo AI 02:
Get started today and revolutionize your video content creation workflow with Hailuo AI 02.
fal-ai/minimax/hailuo-02/pro/text-to-video