Hailuo 02 Pro API by MiniMax
Hailuo 02 is a new AI video generation model from Hailuo AI.
Entrée
Sortie
InactifVotre requête coûtera $0.48 par exécution. Avec $10, vous pouvez exécuter ce modèle environ 20 fois.
Vous pouvez continuer avec :
Exemple de code
import requests
import time
# Step 1: Start video generation
generate_url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "minimax/hailuo-02/pro",
"prompt": "A beautiful sunset over the ocean with gentle waves",
"width": 512,
"height": 512,
"duration": 3,
"fps": 24,
}
generate_response = requests.post(generate_url, headers=headers, json=data)
generate_result = generate_response.json()
prediction_id = generate_result["data"]["id"]
# Step 2: Poll for result
poll_url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
def check_status():
while True:
response = requests.get(poll_url, headers={"Authorization": "Bearer $ATLASCLOUD_API_KEY"})
result = response.json()
if result["data"]["status"] in ["completed", "succeeded"]:
print("Generated video:", result["data"]["outputs"][0])
return result["data"]["outputs"][0]
elif result["data"]["status"] == "failed":
raise Exception(result["data"]["error"] or "Generation failed")
else:
# Still processing, wait 2 seconds
time.sleep(2)
video_url = check_status()Installer
Installez le package requis pour votre langage.
pip install requestsAuthentification
Toutes les requêtes API nécessitent une authentification via une clé API. Vous pouvez obtenir votre clé API depuis le tableau de bord Atlas Cloud.
export ATLASCLOUD_API_KEY="your-api-key-here"En-têtes HTTP
import os
API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {API_KEY}"
}N'exposez jamais votre clé API dans du code côté client ou dans des dépôts publics. Utilisez plutôt des variables d'environnement ou un proxy backend.
Soumettre une requête
import requests
url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "your-model",
"prompt": "A beautiful landscape"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())Soumettre une requête
Soumettez une requête de génération asynchrone. L'API renvoie un identifiant de prédiction que vous pouvez utiliser pour vérifier le statut et récupérer le résultat.
/api/v1/model/generateVideoCorps de la requête
import requests
url = "https://api.atlascloud.ai/api/v1/model/generateVideo"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "minimax/hailuo-02/pro",
"input": {
"prompt": "A beautiful sunset over the ocean with gentle waves"
}
}
response = requests.post(url, headers=headers, json=data)
result = response.json()
print(f"Prediction ID: {result['id']}")
print(f"Status: {result['status']}")Réponse
{
"id": "pred_abc123",
"status": "processing",
"model": "model-name",
"created_at": "2025-01-01T00:00:00Z"
}Vérifier le statut
Interrogez le point de terminaison de prédiction pour vérifier le statut actuel de votre requête.
/api/v1/model/prediction/{prediction_id}Exemple d'interrogation
import requests
import time
prediction_id = "pred_abc123"
url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }
while True:
response = requests.get(url, headers=headers)
result = response.json()
status = result["data"]["status"]
print(f"Status: {status}")
if status in ["completed", "succeeded"]:
output_url = result["data"]["outputs"][0]
print(f"Output URL: {output_url}")
break
elif status == "failed":
print(f"Error: {result['data'].get('error', 'Unknown')}")
break
time.sleep(3)Valeurs de statut
processingLa requête est encore en cours de traitement.completedLa génération est terminée. Les résultats sont disponibles.succeededLa génération a réussi. Les résultats sont disponibles.failedLa génération a échoué. Vérifiez le champ d'erreur.Réponse terminée
{
"data": {
"id": "pred_abc123",
"status": "completed",
"outputs": [
"https://storage.atlascloud.ai/outputs/result.mp4"
],
"metrics": {
"predict_time": 45.2
},
"created_at": "2025-01-01T00:00:00Z",
"completed_at": "2025-01-01T00:00:10Z"
}
}Télécharger des fichiers
Téléchargez des fichiers vers le stockage Atlas Cloud et obtenez une URL utilisable dans vos requêtes API. Utilisez multipart/form-data pour le téléchargement.
/api/v1/model/uploadMediaExemple de téléchargement
import requests
url = "https://api.atlascloud.ai/api/v1/model/uploadMedia"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }
with open("image.png", "rb") as f:
files = {"file": ("image.png", f, "image/png")}
response = requests.post(url, headers=headers, files=files)
result = response.json()
download_url = result["data"]["download_url"]
print(f"File URL: {download_url}")Réponse
{
"data": {
"download_url": "https://storage.atlascloud.ai/uploads/abc123/image.png",
"file_name": "image.png",
"content_type": "image/png",
"size": 1024000
}
}Schema d'entrée
Les paramètres suivants sont acceptés dans le corps de la requête.
Aucun paramètre disponible.
Exemple de corps de requête
{
"model": "minimax/hailuo-02/pro"
}Schema de sortie
L'API renvoie une réponse de prédiction avec les URL des résultats générés.
Exemple de réponse
{
"id": "pred_abc123",
"status": "completed",
"model": "model-name",
"outputs": [
"https://storage.atlascloud.ai/outputs/result.mp4"
],
"metrics": {
"predict_time": 45.2
},
"created_at": "2025-01-01T00:00:00Z",
"completed_at": "2025-01-01T00:00:10Z"
}Atlas Cloud Skills
Atlas Cloud Skills intègre plus de 300 modèles d'IA directement dans votre assistant de codage IA. Une seule commande pour installer, puis utilisez le langage naturel pour générer des images, des vidéos et discuter avec des LLM.
Clients pris en charge
Installer
npx skills add AtlasCloudAI/atlas-cloud-skillsConfigurer la clé API
Obtenez votre clé API depuis le tableau de bord Atlas Cloud et définissez-la comme variable d'environnement.
export ATLASCLOUD_API_KEY="your-api-key-here"Fonctionnalités
Une fois installé, vous pouvez utiliser le langage naturel dans votre assistant IA pour accéder à tous les modèles Atlas Cloud.
Serveur MCP
Le serveur MCP Atlas Cloud connecte votre IDE avec plus de 300 modèles d'IA via le Model Context Protocol. Compatible avec tout client compatible MCP.
Clients pris en charge
Installer
npx -y atlascloud-mcpConfiguration
Ajoutez la configuration suivante au fichier de paramètres MCP de votre IDE.
{
"mcpServers": {
"atlascloud": {
"command": "npx",
"args": [
"-y",
"atlascloud-mcp"
],
"env": {
"ATLASCLOUD_API_KEY": "your-api-key-here"
}
}
}
}Outils disponibles
Schéma API
Schéma non disponibleVeuillez vous connecter pour voir l'historique des requêtes
Vous devez vous connecter pour accéder à l'historique de vos requêtes de modèle.
Se ConnecterWhat Makes Hailuo 02 Outperform Other AI Video Generation Models?
1080P Native Output
Nobody wants blurry footage. Hailuo 02 gives you the full HD 1080P video straight from the model, not upscaled afterwards. This is a huge leap from the previously limited 720P. Your video will look sharp even on those big screens. Ads, explainers, shorts—it all matters if it looks clear. And Hailuo 02 can deliver that clarity with just a few clicks.
Multiple Duration Options
Flexibility means a lot with AI video generation, and Hailuo 02 offers clip format in both 6-second and 10-second formats. Creators can mix and match formats seamlessly, and the length of content becomes more controllable without impacting quality. It's a small detail but has a big impact on workflow. There’s no need to re-render full scenes when mocking up combinations—just generate and combine.
Enhanced Motion & Physical Effects
This model doesn’t merely understand movement—it completely owns it. Hailuo 02 is equipped with state-of-the-art motion rendering, allowing it to capture dynamic scenes and physical interactions more smoothly than most competitors. It adapts easily to prompts involving complex physics, such as flying debris, bouncing objects, or camera shakes. The result: videos that feel organic and cinematic.
Better Scene Transitions
Image-to-video models can sometimes produce awkward cuts or uneven frame stitching, but Hailuo 02 really smooths things out. Transitions between frames resemble real-world camera work more than simple machine stitching. The end result is closer to a movie trailer than a slideshow, especially for creators transforming still images into dynamic sequences.
Real-World Reliability
Hailuo 02 doesn’t just show strong benchmark performance—it delivers in real creative use cases. Users have reported consistent output when repeating the same prompts. This excellent consistency and low randomness is a major benefit for professionals who value repeatability, especially in team environments with high standards.
Lower Cost
AI tools tend to be powerful but pricey—Hailuo 02 is both powerful and affordable. Compared to premium tools like Veo 3 or closed systems like Sora, it offers incredible value. Designed for creators and startups, not just enterprises, it’s a great entry point for building professional-quality video content on a budget.
What Users Are Saying About Hailuo 02
"The physics are insane. I have to say that not every video came out perfect on the first try, but I still got great results really easily. The way cats jump is just… perfect."
"Truly impressed by how well it follows prompts. Even when I pushed the boundaries of imagination, it executed beautifully. Less distortion, stunning fast motion. Welcome back, king!"
"After many long waits, the return of Hailuo AI is here. With their latest model, 02. It packs a punch, with 1080p visuals, physics, prompt adherence strength, and cinematic capabilities. I present to you a compilation of my tests so far."
"With up to 1080p output and 10-second clips, this new model delivers accurate prompt adherence, dynamic motion, and some of the best physics understanding we’ve seen yet. It feels like a serious leap forward!"
Use Cases of Hailuo 02
-
Short-form social content
Ideal for TikTok, Instagram Reels, or YouTube Shorts. Hailuo 02 provides cinematic visuals in just seconds.
-
Ad and product videos
Create high-resolution, motion-rich videos that make products stand out—no full production team required.
-
Game and film prototyping
Rapidly visualize characters, scenes, and trailers before full-scale production.
-
Educational and training videos
Turn complex concepts into visually engaging animated sequences—perfect for teachers, course creators, and businesses.
-
AI-enhanced storytelling
Animate still images into cinematic micro-scenes without any animation skills.
-
Presentation and pitch support
Make your idea or product pitch unforgettable with custom AI-generated video sequences.
Tips for Using Hailuo 02
-
Use cinematic prompts
Think like a director—describe angles, lighting, and scene dynamics to enhance visual richness.
-
Use motion-rich language
Incorporate action verbs like "zoom in," "pan left," or "fly over" to drive dynamic camera effects.
-
Guide your video with a first frame
Uploading a still image helps the model lock in composition, structure, and mood.
-
Start small, go big later
Begin with 6-second clips to test ideas, then extend or merge for longer sequences.
-
Preview, tweak, repeat
Don’t aim for perfection right away. Iterate quickly and refine results through multiple generations.
FAQs
Q1: Does Hailuo 02 support audio generation?
No—for now, it focuses purely on visuals. You can manually pair it with music, voiceovers, or sound effects for full creative control.
Q2: Can I use it for commercial projects?
Absolutely. Just ensure you review the licensing terms and platform policies if you intend to monetize your output.
Q3: How long does video generation take?
Typically, it takes 30 to 90 seconds for a 6-second or 10-second clip, depending on prompt complexity.
Q4: Is there a mobile version?
While there’s no dedicated app, most platforms supporting Hailuo 02 run smoothly on mobile browsers.
