Hailuo 2.3 API
MiniMax Hailuo 2.3 — 2.5배의 효율 향상과 85%의 복잡한 지시 정확도를 갖춘 물리 인식 텍스트-투-비디오와 이미지-투-비디오입니다. 768p와 1080p의 Standard 및 Pro 등급, 크리에이터와 마케터에 최적화된 Fast 변형을 제공합니다.
Standard(768p)와 Pro(1080p) 등급의 텍스트-투-비디오입니다. 이미지-투-비디오는 i2v-standard, i2v-pro, fast, fast-pro 변형이 있습니다. Fast 등급은 768p로 6초와 10초 클립을, Fast Pro는 6초 1080p 출력을 제공합니다.
개요
Hailuo 2.3 API 소개
Hailuo 2.3의 기능, MiniMax 모델 라인업에서의 위치, 그리고 팀들이 이 모델을 선택하는 이유.
MiniMax의 비디오 생성 모델 Hailuo 2.3. WaveSpeedAI REST API로 바로 사용할 수 있습니다. MiniMax Hailuo 2.3 — 2.5배의 효율 향상과 85%의 복잡한 지시 정확도를 갖춘 물리 인식 텍스트-투-비디오와 이미지-투-비디오입니다. 768p와 1080p의 Standard 및 Pro 등급, 크리에이터와 마케터에 최적화된 Fast 변형을 제공합니다.
Standard(768p)와 Pro(1080p) 등급의 텍스트-투-비디오입니다. 이미지-투-비디오는 i2v-standard, i2v-pro, fast, fast-pro 변형이 있습니다. Fast 등급은 768p로 6초와 10초 클립을, Fast Pro는 6초 1080p 출력을 제공합니다.
WaveSpeedAI의 Hailuo 2.3 제품군은 Image-To-Video, Text-To-Video 워크플로를 아우르는 REST 엔드포인트 6개를 제공합니다. 각 변형은 고유한 가격, 파라미터, 예시 출력을 갖고 있으니 입력 방식과 운영 조건에 맞는 것을 고르거나, 같은 API 키로 여러 개를 호출해 다단계 파이프라인을 구성하세요.
Hailuo 2.3 실행에도 WaveSpeedAI의 다른 1,000개 이상의 AI 모델과 같은 API 키, 결제 계정, 요청 한도 체계를 그대로 사용합니다. 별도의 벤더 설정도, 제공사별 SDK도, 벤더별 요청 한도 체계도 필요 없습니다. 하나의 연동으로 텍스트 → 이미지, 텍스트 → 비디오부터 오디오 합성, 3D 생성, 업스케일링, 편집까지 모두 지원합니다.
엔드포인트
Hailuo 2.3 API 전체 엔드포인트
Hailuo 2.3 엔드포인트 6개를 지금 WaveSpeedAI에서 사용할 수 있습니다. 워크플로에 맞는 변형을 고르세요.
/filters:quality(82)/media/images/20260408112434_jhfd7u7l.webp)
Hailuo 2.3 Fast Pro
Hailuo 2.3 Fast Pro converts images into high-quality 6s 1080p videos, delivering fast, affordable results for creators and marketers. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112423_26myekqm.webp)
Hailuo 2.3 Fast
Hailuo 2.3 Fast by minimax generates high-quality 6s and 10s image-to-video clips at 768p, optimized for creators and marketers. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112420_sjqajwbs.webp)
Hailuo 2.3 I2v Pro
MiniMax Hailuo 2.3 Pro is an image-to-video model for ultra-clear 1080P output and physics-aware scenes with responsive rendering. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112430_4w5uuemw.webp)
Hailuo 2.3 I2v Standard
MiniMax Hailuo 2.3 Standard is an image-to-video model producing physics-aware 768p output with a 2.5x efficiency improvement. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112417_ysn1nalp.webp)
Hailuo 2.3 T2v Standard
Hailuo 2.3 is a text-to-video model creating physics-aware 768p videos with 2.5× efficiency and 85% complex instruction response rate. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112426_40ibqzm4.webp)
Hailuo 2.3 T2v Pro
MiniMax Hailuo 2.3 Pro is a text-to-video model delivering 1080p videos with 2.5x efficiency and 85% complex-instruction accuracy. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
예시
Hailuo 2.3 활용 예시
Hailuo 2.3 API로 생성한 실제 출력물입니다. 비디오 위에 마우스를 올리면 미리 보고, 클릭하면 전체 크기 뷰어가 열립니다.
사용 방법
Hailuo 2.3 API 사용 방법
가입부터 결과물 생성까지 네 단계입니다. Python, Node.js, cURL 전체 예시는 아래 API 섹션에 있습니다.
- 01
API 키 받기
WaveSpeedAI 계정을 만들고 대시보드에서 API 키를 복사하세요. 신규 계정에는 무료 스타터 크레딧이 제공되어, 요금이 청구되기 전에 Playground를 수십 번 실행해 볼 수 있습니다.
- 02
Prediction 제출
입력을 JSON으로 https://api.wavespeed.ai/api/v3/minimax/hailuo-2.3/t2v-standard에 POST하세요. 엔드포인트가 prediction id를 즉시 반환합니다. 생성은 비동기로 처리되므로 추론 중에 연결을 계속 열어 둘 필요가 없습니다.
- 03
완료될 때까지 폴링
https://api.wavespeed.ai/api/v3/predictions/{request_id}/result로 GET 요청을 보내세요. completed이면 outputs를 반환하고, failed, cancelled, timeout, deleted이면 오류로 종료하며, 그 밖의 모든 status에서는 폴링을 계속합니다.
- 04
출력 URL 읽기
status가 "completed"가 되면 data.outputs[0]에서 URL을 읽으세요. 이 URL은 WaveSpeedAI CDN에 있는 생성된 미디어를 가리키며, 호출한 Hailuo 2.3 변형에 따라 이미지, 비디오, 오디오 또는 3D 파일입니다.
활용 사례
Hailuo 2.3 활용 사례
개발자와 크리에이터가 Hailuo 2.3 API를 사용하는 대표적인 워크플로입니다.
768p의 물리 인식 텍스트-투-비디오
minimax/hailuo-2.3/t2v-standard는 2.5배의 효율과 85%의 복잡한 지시 반영률로 물리를 인식하는 768p 비디오를 만듭니다. 텍스트에서 프롬프트 기반 비디오를 만드는 Standard 등급입니다.
1080p의 Pro 텍스트-투-비디오
minimax/hailuo-2.3/t2v-pro는 2.5배의 효율과 85%의 복잡한 지시 정확도로 1080p 비디오를 제공합니다. 납품 해상도와 지시 이행이 가장 중요할 때의 Pro 등급입니다.
물리를 인식하는 장면의 이미지-투-비디오
minimax/hailuo-2.3/i2v-standard와 i2v-pro는 이미지를 각각 768p와 1080p의 물리 인식 비디오로 변환합니다. 카탈로그에 따르면 복잡한 물리 기반 장면에 대응하는 렌더링을 제공합니다.
6초 및 10초 클립을 위한 Fast 등급
minimax/hailuo-2.3/fast는 크리에이터와 마케터에 최적화된 고품질 6초 및 10초 이미지-투-비디오 클립을 768p로 생성합니다. 짧은 길이와 빠른 처리가 중요한 소셜 콘텐츠에 유용합니다.
1080p 속도를 위한 Fast Pro
minimax/hailuo-2.3/fast-pro는 이미지를 빠르고 합리적인 비용으로 고품질 6초 1080p 비디오로 변환합니다. 크리에이터 워크플로를 위한 속도 최적화 1080p 등급입니다.
복잡한 지시 이행
카탈로그 설명: 텍스트-투-비디오 변형 전반에서 85%의 복잡한 지시 정확도. 피사체, 액션, 환경, 카메라 표현을 담은 여러 절의 프롬프트를 작성하세요. Hailuo 2.3은 지시가 많은 브리프에 맞춰 조정되어 있습니다.
팁
Hailuo 2.3 프롬프트 작성 팁
Hailuo 2.3에서 더 나은 결과를 얻기 위한 실용적인 조언입니다. 운영 파이프라인에서 비디오 모델 전반에 통하는 패턴을 바탕으로 했습니다.
- 01
소셜 숏폼에는 Fast 등급을 사용하세요
Fast는 768p로 6초와 10초 클립을, Fast Pro는 1080p로 6초 클립을 생성합니다. 크리에이터와 마케터에 최적화되어 있으며, 길이가 정해져 있고 처리 시간이 중요할 때 선택하세요.
- 02
복잡한 여러 절의 프롬프트를 쓰세요
카탈로그 설명: 85%의 복잡한 지시 정확도. Hailuo 2.3은 피사체, 액션, 환경, 카메라, 스타일을 한 프롬프트에 담는, 지시가 많은 브리프에 맞춰 조정되어 있습니다.
- 03
해상도에 따라 Standard와 Pro를 고르세요
반복 작업에는 768p의 t2v-standard와 i2v-standard, 납품에는 1080p의 t2v-pro와 i2v-pro를 사용하세요. 프롬프트 형식은 등급 전반에서 같습니다.
- 04
물리를 인식하는 장면에는 명시적인 모션이 필요합니다
카탈로그는 물리를 인식하는 렌더링을 강조합니다. 정적인 장면 묘사에 그치지 말고 물체 간 상호작용, 중력, 재질의 거동을 묘사하세요.
- 05
제품과 라이프스타일에는 이미지-투-비디오
i2v 변형은 제품 사진과 라이프스타일 스틸에 반응성 좋은 물리 인식 렌더링으로 움직임을 줍니다. 기존 사진에서 이커머스와 광고 크리에이티브를 만들 때 유용합니다.
가격
Hailuo 2.3 API 가격
가격은 출력당 책정됩니다. 최종 요금은 각 변형의 Playground에서 설정한 파라미터(해상도, 길이, 출력 수, 레퍼런스)에 따라 달라집니다.
| 엔드포인트 | 유형 | 시작 가격 |
|---|---|---|
| minimax/ | image-to-video | $0.33 |
| minimax/ | image-to-video | $0.19 |
| minimax/ | image-to-video | $0.49 |
| minimax/ | image-to-video | $0.28 |
| minimax/ | text-to-video | $0.28 |
| minimax/ | text-to-video | $0.49 |
API
Hailuo 2.3 API 호출하기
wavespeed.ai/accesskey에서 API 키를 발급받은 뒤 REST로 prediction을 제출하세요. Playground에서 입력 조합별로 바로 붙여넣을 수 있는 샘플이 생성됩니다.
POSThttps://api.wavespeed.ai/api/v3/minimax/hailuo-2.3/t2v-standard
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/minimax/hailuo-2.3/t2v-standard" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"duration": 6,
"enable_prompt_expansion": false
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/minimax/hailuo-2.3/t2v-standard";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"duration": 6,
"enable_prompt_expansion": false
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"duration": 6,
"enable_prompt_expansion": False
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/minimax/hailuo-2.3/t2v-standard", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)비교
Hailuo 2.3 vs 대안
비슷한 WaveSpeedAI 모델과 비교한 Hailuo 2.3의 선택 기준.
Hailuo 2.3 vs Hailuo 02
Hailuo 02는 비슷한 해상도에서 Standard/Pro/Fast 등급 구조가 비슷한 이전 세대입니다. Hailuo 2.3은 2.5배의 효율 향상과 85%의 복잡한 지시 정확도를 대표적인 개선점으로 추가했습니다.
Hailuo 2.3 vs Seedance 1.5 Pro
Seedance 1.5 Pro는 더 낮은 가격대에서 스마트 길이, 시드, video-extend, 선택형 오디오를 제공합니다. Hailuo 2.3은 물리 인식 렌더링과 복잡한 지시 정확도를 강조하며, 크리에이터 워크플로를 위한 전용 Fast 등급이 있습니다.
Hailuo 2.3 vs Wan 2.6
Wan 2.6은 같은 패밀리에 동기화된 오디오, 레퍼런스-투-비디오, video-extend, image-edit를 제공합니다. Hailuo 2.3은 텍스트-투-비디오와 이미지-투-비디오에 집중하며, 물리 인식 렌더링과 숏폼 콘텐츠를 위한 Fast 등급을 제공합니다.
FAQ
Hailuo 2.3 API — 자주 묻는 질문
가격, 라이선스, 연동 — WaveSpeedAI에서 Hailuo 2.3 실행에 관한 자주 묻는 질문.
Hailuo 2.3 API란 무엇인가요?
Hailuo 2.3 — WaveSpeedAI에서 REST API로 제공되는 MiniMax의 비디오 생성 모델입니다. MiniMax Hailuo 2.3 — 2.5배의 효율 향상과 85%의 복잡한 지시 정확도를 갖춘 물리 인식 텍스트-투-비디오와 이미지-투-비디오입니다. 768p와 1080p의 Standard 및 Pro 등급, 크리에이터와 마케터에 최적화된 Fast 변형을 제공합니다. 프로그래밍 방식으로 호출하거나 위에 링크된 Playground에서 체험해 볼 수 있습니다.
Hailuo 2.3 API는 어떻게 호출하나요?
WaveSpeedAI 계정을 만들고 /accesskey에서 API 키를 복사한 뒤, 입력을 JSON으로 https://api.wavespeed.ai/api/v3/minimax/hailuo-2.3/t2v-standard에 POST하세요. 엔드포인트가 prediction id를 반환합니다. 결과 엔드포인트 폴링은 약 2초마다 시작하고, 오래 걸리는 작업은 간격을 늘리며, 종료 status가 나오면 중단하세요. 운영 환경용 Python / Node.js / cURL 예시는 위에 있습니다.
Hailuo 2.3 API 요금은 얼마인가요?
Hailuo 2.3의 가격은 회당 $0.19부터입니다. 정확한 비용은 설정한 파라미터(해상도, 길이, 출력 수, 레퍼런스)에 따라 달라집니다. Playground의 생성 버튼 옆 실시간 비용 미리보기에서 현재 입력 기준의 정확한 가격을 확인할 수 있습니다.
Hailuo 2.3에는 어떤 변형이 있나요?
WaveSpeedAI에는 라이브 Hailuo 2.3 엔드포인트가 6개 있습니다: minimax/hailuo-2.3/fast-pro, minimax/hailuo-2.3/fast, minimax/hailuo-2.3/i2v-pro, minimax/hailuo-2.3/i2v-standard, minimax/hailuo-2.3/t2v-standard, minimax/hailuo-2.3/t2v-pro. 각 변형에는 고유한 Playground 페이지와 가격이 있습니다.
Hailuo 2.3 출력물을 상업적으로 사용할 수 있나요?
상업적 사용 권한은 MiniMax 모델 라이선스를 따릅니다. 대부분의 MiniMax 모델은 출력물의 상업적 사용을 허용합니다. 구체적인 라이선스 요약은 각 모델의 Playground 페이지를, 플랫폼 수준의 조건은 WaveSpeedAI 이용약관을 참고하세요.
직접 연동하지 않고 WaveSpeedAI에서 Hailuo 2.3 모델을 사용하는 이유는 무엇인가요?
API 키 하나와 결제 계정 하나로 Hailuo 2.3 모델과 다른 제공사의 1,000개 이상의 AI 모델을 모두 사용합니다. 벤더별 SDK 설정도, 별도의 요청 한도 체계도, 벤더마다 연동 코드를 다시 쓸 일도 없습니다. 가격은 대체로 MiniMax의 직접 API와 같거나 더 저렴합니다.
제공사
MiniMax 소개
WaveSpeedAI의 Hailuo 2.3 및 MiniMax 전체 모델 라인업을 만든 팀.
MiniMax는 Hailuo 비디오 생성과 음성 모델로 알려진 중국 AI 연구소입니다. Hailuo 2.3은 Standard, Pro, Fast 등급의 물리 인식 텍스트-투-비디오와 이미지-투-비디오를 제공하며, 크리에이터와 마케팅 워크플로를 위한 2.5배의 효율과 뛰어난 복잡한 지시 정확도를 내세웁니다.
WaveSpeedAI에서 Hailuo 2.3 시작하기
가입 시 무료 스타터 크레딧 제공. MiniMax 및 다른 모든 제공사의 1,000개 이상 AI 모델을 API 키 하나로.