Hailuo 02 is a new AI video generation model from Hailuo AI.
Hailuo 02 is a new AI video generation model, from Hailuo AI, created on MiniMax's evolving framework. It has been fine-tuned to deliver ultra-clear 1080P resolution and unprecedented responsiveness while even handling, the craziest of physics driven scenes.
Join the Discord community for the latest model updates, prompts, and support.
Cada execução custará $0.28. Com $10 você pode executar aproximadamente 35 vezes.
Você pode continuar com:
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/i2v-standard", # Required. model name
"image": "https://static.atlascloud.ai/media/images/1751883836278138425_vVeazvso.jpeg", # Required. The model generates video with the picture passed in as the first frame
"prompt": "The girl in the image begins performing a graceful ballet solo on a grand theater stage, she twirls and lifts one leg into an arabesque, soft spotlight follows her every move, cinematic lighting, slow camera pan from left to right, elegant and fluid motion", # Generate a description of the video
"duration": 6, # The duration of the generated media in seconds. options: 6 | 10
"enable_prompt_expansion": False, # The model automatically optimizes incoming prompts to enhance output quality
}
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()Instale o pacote necessário para a sua linguagem de programação.
pip install requestsTodas as solicitações de API requerem autenticação por meio de uma chave de API. Você pode obter sua chave de API no painel do Atlas Cloud.
export ATLASCLOUD_API_KEY="your-api-key-here"import os
API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {API_KEY}"
}Nunca exponha sua chave de API em código do lado do cliente ou repositórios públicos. Use variáveis de ambiente ou um proxy de backend.
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())Envie uma solicitação de geração assíncrona. A API retorna um ID de predição que você pode usar para verificar o status e obter o resultado.
/api/v1/model/generateVideoimport 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/i2v-standard",
"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['data']['id']}")
print(f"Status: {result['data']['status']}"){
"code": 200,
"data": {
"id": "pred_abc123",
"status": "processing",
"model": "model-name",
"created_at": "2025-01-01T00:00:00Z"
}
}Consulte o endpoint de predição para verificar o status atual da sua solicitação.
/api/v1/model/prediction/{prediction_id}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)processingA solicitação ainda está sendo processada.completedA geração está completa. As saídas estão disponíveis.succeededA geração foi bem-sucedida. As saídas estão disponíveis.failedA geração falhou. Verifique o campo de erro.{
"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"
}
}Envie arquivos para o armazenamento do Atlas Cloud e obtenha uma URL que pode ser usada nas suas solicitações de API. Use multipart/form-data para enviar.
/api/v1/model/uploadMediaimport 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}"){
"data": {
"download_url": "https://storage.atlascloud.ai/uploads/abc123/image.png",
"file_name": "image.png",
"content_type": "image/png",
"size": 1024000
}
}Os seguintes parâmetros são aceitos no corpo da solicitação.
{
"model": "minimax/hailuo-02/i2v-standard",
"image": "https://static.atlascloud.ai/media/images/1751883836278138425_vVeazvso.jpeg",
"prompt": "The girl in the image begins performing a graceful ballet solo on a grand theater stage, she twirls and lifts one leg into an arabesque, soft spotlight follows her every move, cinematic lighting, slow camera pan from left to right, elegant and fluid motion",
"duration": 6,
"enable_prompt_expansion": false
}A API retorna uma resposta de predição com as URLs de saída geradas.
{
"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"
}O Atlas Cloud Skills integra mais de 400 modelos de IA diretamente no seu assistente de codificação com IA. Um comando para instalar e depois use linguagem natural para gerar imagens, vídeos e conversar com LLM.
npx skills add AtlasCloudAI/atlas-cloud-skillsObtenha sua chave de API no painel do Atlas Cloud e defina-a como variável de ambiente.
export ATLASCLOUD_API_KEY="your-api-key-here"Após a instalação, você pode usar linguagem natural no seu assistente de IA para acessar todos os modelos do Atlas Cloud.
O Atlas Cloud MCP Server conecta seu IDE com mais de 400 modelos de IA através do Model Context Protocol. Funciona com qualquer cliente compatível com MCP.
npx -y atlascloud-mcpAdicione a seguinte configuração ao arquivo de configuração de MCP do seu IDE.
{
"mcpServers": {
"atlascloud": {
"command": "npx",
"args": [
"-y",
"atlascloud-mcp"
],
"env": {
"ATLASCLOUD_API_KEY": "your-api-key-here"
}
}
}
}{
"info": {
"title": "AtlasCloud API",
"version": "1.0.0",
"description": "The AtlasCloud API."
},
"paths": {
"/api/v1/model/generateVideo": {
"post": {
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PredictionResponse"
}
}
},
"description": "The request status."
}
},
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Input"
}
}
},
"required": true
}
},
"x-api-name": "model_run"
},
"/api/v1/model/result/{request_id}": {
"get": {
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PredictionResponse"
}
}
},
"description": "Result of the request."
}
},
"parameters": [
{
"in": "path",
"name": "request_id",
"schema": {
"type": "string",
"description": "Request ID"
},
"required": true
}
]
},
"x-api-name": "model_result"
}
},
"openapi": "3.0.0",
"servers": [
{
"url": "https://api.atlascloud.ai"
}
],
"components": {
"schemas": {
"Input": {
"type": "object",
"required": [
"model",
"image"
],
"properties": {
"model": {
"type": "string",
"description": "model name",
"default": "minimax/hailuo-02/i2v-standard"
},
"image": {
"type": "string",
"default": "https://static.atlascloud.ai/media/images/1751883836278138425_vVeazvso.jpeg",
"description": "The model generates video with the picture passed in as the first frame.Base64 encoded strings in data:image/jpeg; base64,{data} format for incoming images, or URLs accessible via the public network. The uploaded image needs to meet the following conditions: Format is JPG/JPEG/PNG; The aspect ratio is greater than 2:5 and less than 5:2; Short side pixels greater than 300px; The image file size cannot exceed 20MB."
},
"prompt": {
"type": "string",
"default": "The girl in the image begins performing a graceful ballet solo on a grand theater stage, she twirls and lifts one leg into an arabesque, soft spotlight follows her every move, cinematic lighting, slow camera pan from left to right, elegant and fluid motion",
"maxLength": 2000,
"description": "Generate a description of the video."
},
"duration": {
"enum": [
6,
10
],
"type": "integer",
"default": 6,
"description": "The duration of the generated media in seconds.",
"x-ui-component": "select"
},
"enable_prompt_expansion": {
"type": "boolean",
"default": false,
"description": "The model automatically optimizes incoming prompts to enhance output quality. This also activates the safety checker, which ensures content safety by detecting and filtering potential risks."
}
},
"x-order-properties": [
"model",
"prompt",
"image",
"duration",
"enable_prompt_expansion"
]
},
"PredictionResponse": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the prediction, the ID of the prediction to get."
},
"urls": {
"type": "object",
"description": "Object containing related API endpoints."
},
"model": {
"type": "string",
"description": "Model ID used for the prediction."
},
"status": {
"type": "string",
"description": "Status of the task: created, processing, completed, or failed."
},
"outputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of URLs to the generated content (empty when status is not completed)."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)."
},
"has_nsfw_contents": {
"type": "array",
"items": {
"type": "boolean"
},
"description": "Array of boolean values indicating NSFW detection for each output."
}
}
}
},
"securitySchemes": {
"apiKeyAuth": {
"in": "header",
"name": "Authorization",
"type": "apiKey"
}
}
}
}# minimax/hailuo-02/i2v-standard
> Hailuo 02 is a new AI video generation model from Hailuo AI.
## Overview
- **Submit endpoint (POST)**: `https://api.atlascloud.ai/api/v1/model/generateVideo` — start an async generation; returns a `prediction_id`
- **Poll endpoint (GET)**: `https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}` — poll this until the prediction finishes
- **Model ID**: `minimax/hailuo-02/i2v-standard`
## API Information
This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.
### Input Schema
The API accepts the following input parameters:
- **`model`** (`string`, _required_):
model name
- Default: `"minimax/hailuo-02/i2v-standard"`
- **`prompt`** (`string`, _optional_):
Generate a description of the video.
- Default: `"The girl in the image begins performing a graceful ballet solo on a grand theater stage, she twirls and lifts one leg into an arabesque, soft spotlight follows her every move, cinematic lighting, slow camera pan from left to right, elegant and fluid motion"`
- **`image`** (`string`, _required_):
The model generates video with the picture passed in as the first frame.Base64 encoded strings in data:image/jpeg; base64,{data} format for incoming images, or URLs accessible via the public network. The uploaded image needs to meet the following conditions: Format is JPG/JPEG/PNG; The aspect ratio is greater than 2:5 and less than 5:2; Short side pixels greater than 300px; The image file size cannot exceed 20MB.
- Default: `"https://static.atlascloud.ai/media/images/1751883836278138425_vVeazvso.jpeg"`
- **`duration`** (`integer`, _optional_):
The duration of the generated media in seconds.
- Default: `6`
- Options: 6, 10
- **`enable_prompt_expansion`** (`boolean`, _optional_):
The model automatically optimizes incoming prompts to enhance output quality. This also activates the safety checker, which ensures content safety by detecting and filtering potential risks.
- Default: `false`
**Required Parameters Example**:
```json
{
"model": "minimax/hailuo-02/i2v-standard",
"image": "https://static.atlascloud.ai/media/images/1751883836278138425_vVeazvso.jpeg"
}
```
**Full Example**:
```json
{
"model": "minimax/hailuo-02/i2v-standard",
"prompt": "The girl in the image begins performing a graceful ballet solo on a grand theater stage, she twirls and lifts one leg into an arabesque, soft spotlight follows her every move, cinematic lighting, slow camera pan from left to right, elegant and fluid motion",
"image": "https://static.atlascloud.ai/media/images/1751883836278138425_vVeazvso.jpeg",
"duration": 6,
"enable_prompt_expansion": false
}
```
### Output Schema
The API returns the following output format:
- **`id`** (`string`, _optional_):
Unique identifier for the prediction, the ID of the prediction to get.
- **`urls`** (`object`, _optional_):
Object containing related API endpoints.
- **`model`** (`string`, _optional_):
Model ID used for the prediction.
- **`status`** (`string`, _optional_):
Status of the task: created, processing, completed, or failed.
- **`outputs`** (`array[string]`, _optional_):
Array of URLs to the generated content (empty when status is not completed).
- **`created_at`** (`string`, _optional_):
ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”).
- **`has_nsfw_contents`** (`array[boolean]`, _optional_):
Array of boolean values indicating NSFW detection for each output.
**Example Response**:
```json
{
"id": "",
"urls": {},
"model": "",
"status": "",
"outputs": [
""
],
"created_at": "",
"has_nsfw_contents": []
}
```
## Usage Examples
### cURL
```bash
# Step 1: Start generation (async)
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateVideo" \
-H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax/hailuo-02/i2v-standard",
"prompt": "The girl in the image begins performing a graceful ballet solo on a grand theater stage, she twirls and lifts one leg into an arabesque, soft spotlight follows her every move, cinematic lighting, slow camera pan from left to right, elegant and fluid motion",
"image": "https://static.atlascloud.ai/media/images/1751883836278138425_vVeazvso.jpeg",
"duration": 6,
"enable_prompt_expansion": false
}'
# Response will contain: {"code": 200, "data": {"id": "prediction_id", "status": "processing"}}
# Step 2: Poll for result (replace {prediction_id} with the id returned above)
curl -X GET "https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}" \
-H "Authorization: Bearer $ATLASCLOUD_API_KEY"
# Keep polling until status is "completed", "succeeded" or "failed"
# When completed, outputs will contain the generated content URL(s)
```
## Additional Resources
### Documentation
- [Model Playground](https://www.atlascloud.ai/models/minimax/hailuo-02/i2v-standard)
Close-up, high-definition shot of a rusty, weathered vintage car in a desolate desert, cinematic dust clouds, harsh sunlight, intricate textures, dust particles in air, 100mm lens, professional automotive photography.
Close-up, high-definition shot of a rusty, weathered vintage car in a desolate desert, cinematic dust clouds, harsh sunlight, intricate textures, dust particles in air, 100mm lens, professional automotive photography.
A playful puppy, excitedly chasing a rolling ball across a lush green park. Its ears flap in the wind, and its tail wags furiously. Low-angle tracking shot, bright daylight, energetic and cheerful ambiance.
A playful puppy, excitedly chasing a rolling ball across a lush green park. Its ears flap in the wind, and its tail wags furiously. Low-angle tracking shot, bright daylight, energetic and cheerful ambiance.
The girl in the image begins performing a graceful ballet solo on a grand theater stage, she twirls and lifts one leg into an arabesque, soft spotlight follows her every move, cinematic lighting, slow camera pan from left to right, elegant and fluid motion
The girl in the image begins performing a graceful ballet solo on a grand theater stage, she twirls and lifts one leg into an arabesque, soft spotlight follows her every move, cinematic lighting, slow camera pan from left to right, elegant and fluid motion
The girl in the image starts moving gracefully through a misty forest, twirling slowly, extending her arms as leaves swirl around her, camera rotates gently around her body, cinematic lighting, realistic motion
The girl in the image starts moving gracefully through a misty forest, twirling slowly, extending her arms as leaves swirl around her, camera rotates gently around her body, cinematic lighting, realistic motion
The girl in the image performs a powerful contemporary dance on a dimly lit stage, her arms sweep dramatically, her body spins and contracts with emotion, moody spotlight and rotating camera, fast yet expressive motion
The girl in the image performs a powerful contemporary dance on a dimly lit stage, her arms sweep dramatically, her body spins and contracts with emotion, moody spotlight and rotating camera, fast yet expressive motion
The boy in the image breaks into a high-energy hip-hop dance on an urban rooftop, spinning, body popping, footwork fast and rhythmic, wide-angle drone camera sweeps across the scene, cinematic tone
The boy in the image breaks into a high-energy hip-hop dance on an urban rooftop, spinning, body popping, footwork fast and rhythmic, wide-angle drone camera sweeps across the scene, cinematic tone
The dancer in the image gracefully moves across the stage with a flowing silk ribbon, spinning and leaping, ribbon twirls through the air, elegant camera dolly-in, warm stage lighting
The dancer in the image gracefully moves across the stage with a flowing silk ribbon, spinning and leaping, ribbon twirls through the air, elegant camera dolly-in, warm stage lighting
The man in the image performs a slow and controlled Tai Chi sequence in a misty mountain setting, his hands flow like water, camera slowly zooms and pans, peaceful and meditative motion
The man in the image performs a slow and controlled Tai Chi sequence in a misty mountain setting, his hands flow like water, camera slowly zooms and pans, peaceful and meditative motion
Pixel art style,An inquisitive squirrel, busily burying nuts in a sun-dappled forest floor. Leaves crunch softly under its tiny paws, and dappled light filters through the canopy. Close-up, natural lighting, peaceful and lively ambiance.
Pixel art style,An inquisitive squirrel, busily burying nuts in a sun-dappled forest floor. Leaves crunch softly under its tiny paws, and dappled light filters through the canopy. Close-up, natural lighting, peaceful and lively ambiance.
Masterpiece, ultra-detailed, photorealistic portrait of an ancient wise wizard with glowing eyes, dramatic volumetric lighting, cinematic, studio shot, sharp focus, 8k, award-winning photography.
Masterpiece, ultra-detailed, photorealistic portrait of an ancient wise wizard with glowing eyes, dramatic volumetric lighting, cinematic, studio shot, sharp focus, 8k, award-winning photography.
An epic scene, a colossal ancient dragon perched atop a jagged volcanic peak, smoke billowing, lava flowing, storm clouds gathering, dramatic lighting, fantasy art, cinematic, highly detailed scales, breathtaking.
An epic scene, a colossal ancient dragon perched atop a jagged volcanic peak, smoke billowing, lava flowing, storm clouds gathering, dramatic lighting, fantasy art, cinematic, highly detailed scales, breathtaking.
A majestic golden retriever, with sun-drenched fur and playful eyes, running through a field of vibrant green grass under a clear blue sky, golden hour lighting, cinematic photography.
A majestic golden retriever, with sun-drenched fur and playful eyes, running through a field of vibrant green grass under a clear blue sky, golden hour lighting, cinematic photography.