Hailuo 02 t2v Standard API by MiniMax
Hailuo 02 is a new AI video generation model from Hailuo AI.
입력
출력
대기요청당 $0.23가 소요됩니다. $10로 이 모델을 약 43번 실행할 수 있습니다.
다음으로 할 수 있는 작업:
코드 예시
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/t2v-standard",
"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()설치
사용하는 언어에 필요한 패키지를 설치하세요.
pip install requests인증
모든 API 요청에는 API 키를 통한 인증이 필요합니다. Atlas Cloud 대시보드에서 API 키를 받을 수 있습니다.
export ATLASCLOUD_API_KEY="your-api-key-here"HTTP 헤더
import os
API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {API_KEY}"
}클라이언트 측 코드나 공개 저장소에 API 키를 노출하지 마세요. 대신 환경 변수 또는 백엔드 프록시를 사용하세요.
요청 제출
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())요청 제출
비동기 생성 요청을 제출합니다. API는 상태 확인 및 결과 조회에 사용할 수 있는 예측 ID를 반환합니다.
/api/v1/model/generateVideo요청 본문
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/t2v-standard",
"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']}")응답
{
"id": "pred_abc123",
"status": "processing",
"model": "model-name",
"created_at": "2025-01-01T00:00:00Z"
}상태 확인
예측 엔드포인트를 폴링하여 요청의 현재 상태를 확인합니다.
/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)상태 값
processing요청이 아직 처리 중입니다.completed생성이 완료되었습니다. 출력을 사용할 수 있습니다.succeeded생성이 성공했습니다. 출력을 사용할 수 있습니다.failed생성에 실패했습니다. 오류 필드를 확인하세요.완료 응답
{
"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"
}
}파일 업로드
Atlas Cloud 스토리지에 파일을 업로드하고 API 요청에 사용할 수 있는 URL을 받습니다. multipart/form-data를 사용하여 업로드합니다.
/api/v1/model/uploadMedia업로드 예시
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}")응답
{
"data": {
"download_url": "https://storage.atlascloud.ai/uploads/abc123/image.png",
"file_name": "image.png",
"content_type": "image/png",
"size": 1024000
}
}입력 Schema
다음 매개변수가 요청 본문에서 사용 가능합니다.
사용 가능한 매개변수가 없습니다.
요청 본문 예시
{
"model": "minimax/hailuo-02/t2v-standard"
}출력 Schema
API는 생성된 출력 URL이 포함된 예측 응답을 반환합니다.
응답 예시
{
"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는 300개 이상의 AI 모델을 AI 코딩 어시스턴트에 직접 통합합니다. 한 번의 명령으로 설치하고 자연어로 이미지, 동영상 생성 및 LLM과 대화할 수 있습니다.
지원 클라이언트
설치
npx skills add AtlasCloudAI/atlas-cloud-skillsAPI 키 설정
Atlas Cloud 대시보드에서 API 키를 받아 환경 변수로 설정하세요.
export ATLASCLOUD_API_KEY="your-api-key-here"기능
설치 후 AI 어시스턴트에서 자연어를 사용하여 모든 Atlas Cloud 모델에 접근할 수 있습니다.
MCP Server
Atlas Cloud MCP Server는 Model Context Protocol을 통해 IDE와 300개 이상의 AI 모델을 연결합니다. MCP 호환 클라이언트에서 사용할 수 있습니다.
지원 클라이언트
설치
npx -y atlascloud-mcp설정
다음 설정을 IDE의 MCP 설정 파일에 추가하세요.
{
"mcpServers": {
"atlascloud": {
"command": "npx",
"args": [
"-y",
"atlascloud-mcp"
],
"env": {
"ATLASCLOUD_API_KEY": "your-api-key-here"
}
}
}
}사용 가능한 도구
API 스키마
스키마를 사용할 수 없음What 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.
