Hailuo API: Hailuo 2.3, Hailuo 02, MiniMax H3
MiniMax는 두 가지 영상 계열을 판매합니다. 생동감 있는 움직임으로 알려진 Hailuo 모델과, 소리와 2K 출력을 지원하는 신형 MiniMax H3입니다. 이 가이드는 Revana의 모든 버전, 각각의 초당 비용, 호출 방법을 다룹니다.
하나의 API로 사용하는 Hailuo 및 MiniMax 영상 모델
Hailuo는 액션, 댄스, 신체 움직임 등 역동적인 모션으로 알려진 MiniMax의 영상 모델 계열입니다. MiniMax의 최신 영상 모델인 H3는 MiniMax 이름으로 판매됩니다. Revana는 두 계열을 같은 요청 형식으로 제공합니다.
| 모델 | 모델 id | 기능 | 해상도 | 길이 | 시작가 | 경로 |
|---|---|---|---|---|---|---|
| Hailuo 2.3 | hailuo-2.3 | 텍스트 투 비디오, 이미지 투 비디오 | 768p, 1080p | 6초 또는 10초 | $0.06 / s | 경로 2개 |
| Hailuo 2.3 Fast | hailuo-2.3-fast | 이미지 투 비디오 | 768p, 1080p | 6초 또는 10초 | $0.04 / s | 경로 1개 |
| Hailuo 2.3 Standard | hailuo-2.3-std | 이미지 투 비디오 | 768p, 1080p | 6초 또는 10초 | $0.04 / s | 경로 1개 |
| Hailuo 02 | hailuo-02 | 텍스트 투 비디오, 이미지 투 비디오, 첫·마지막 프레임 | 512p, 768p, 1080p | 5초 또는 10초 | $0.02 / s | 경로 2개 |
| Hailuo 02 Pro | hailuo-02-pro | 텍스트 투 비디오, 이미지 투 비디오 | 1080p | 6 s | $0.06 / s | 경로 1개 |
| MiniMax H3 | minimax-h3 | 텍스트 투 비디오, 이미지 투 비디오, 첫·마지막 프레임, 참조 이미지, 소리 포함 | 768p, 2K | 4~15초 | $0.03 / s | 경로 3개 |
| MiniMax H3 Max | minimax-h3-max | 텍스트 투 비디오, 이미지 투 비디오, 참조 이미지 | 480p, 768p, 1080p | 5~15초 | $0.05 / s | 경로 1개 |
Hailuo 2.3 Fast와 Standard는 보내 주신 이미지를 움직이게만 합니다. 프롬프트만으로 클립을 만들려면 Hailuo 2.3, Hailuo 02, MiniMax H3를 사용하세요.
어떤 모델을 써야 할까
- MiniMax H3는 가장 최신이며 가장 유연합니다. 최대 15초 클립, 영상과 함께 생성되는 소리, 최대 9장의 참조 이미지, 초당 $0.04의 2K 설정을 지원합니다. 항상 소리를 생성하므로
audio: false는 보내지 마세요. - Hailuo 2.3은 스포츠, 댄스, 스턴트처럼 움직임이 많은 샷에 적합하며, 프롬프트나 시작 이미지로 만듭니다.
- Hailuo 2.3 Fast는 768p에서 초당 $0.04로 정지 이미지를 움직이게 하며, 이미지 투 비디오로는 낮은 가격입니다.
- Hailuo 02는 클립이 한 이미지에서 시작해 다른 이미지로 끝나야 할 때 쓰는 모델이며, 초당 $0.02인 512p 설정은 이미지 투 비디오 아이디어를 저렴하게 테스트하기 좋습니다.
저희는 품질 점수를 공개하지 않습니다. 이 중 두 모델에서 같은 프롬프트를 렌더링해 비교해 보세요.
Hailuo 및 MiniMax 가격 (2026년 10월)
모두 출력 1초당 청구됩니다. 표는 표시된 요금과 각 설정의 일반적인 클립 비용을 보여 줍니다.
| 모델 | 해상도 | 초당 | 6초 클립 | 10초 클립 |
|---|---|---|---|---|
| Hailuo 2.3 | 768p | $0.06 | $0.36 | $0.60 |
| Hailuo 2.3 | 1080p | $0.09 | $0.54 | 6초만 가능 |
| Hailuo 2.3 Fast | 768p | $0.04 | $0.24 | $0.40 |
| Hailuo 2.3 Fast | 1080p | $0.06 | $0.36 | 6초만 가능 |
| Hailuo 02 | 768p | $0.04 | 5 s: $0.20 | $0.40 |
| MiniMax H3 | 768p | $0.03 | $0.18 | $0.30 |
| MiniMax H3 | 2K | $0.04 | $0.24 | $0.40 |
| MiniMax H3 Max | 1080p | $0.16 | $0.96 | $1.60 |
Hailuo 모델은 모든 경로가 1080p 10초 클립을 지원하지는 않으므로, 1080p에서는 6초를 기준으로 계획하고 10초 클립은 768p를 사용하세요. MiniMax H3에는 그런 제약이 없어서, 어느 설정에서든 4~15초의 모든 길이를 사용할 수 있습니다. 다른 영상 모델과의 비교는 가장 저렴한 영상 API 가이드를 참고하세요.
MiniMax H3 클립 생성하기
POST /v1/generations를 보낸 다음, 생성이 succeeded 또는 failed 상태가 될 때까지 몇 초마다 폴링하세요. 소리가 있는 이 10초 2K 클립은 $0.40입니다.
export REVANA_API_KEY="sr_live_..."
# 1. Submit the job (returns 202 with the generation id)
curl https://api.revana.si/v1/generations \
-H "Authorization: Bearer $REVANA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3",
"input": {
"prompt": "A breakdancer spins on one hand in an empty car park at dusk, the camera circling low around him. Sneakers squeak on concrete, a beat echoes from a speaker.",
"resolution": "2K",
"duration": 10,
"aspect_ratio": "16:9"
},
"max_cost_usd": 0.5
}'
# 2. Poll with the id from step 1 until status is "succeeded" or "failed"
curl https://api.revana.si/v1/generations/gen_01JC2V8K5T \
-H "Authorization: Bearer $REVANA_API_KEY"import os
import time
import requests
API = "https://api.revana.si/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['REVANA_API_KEY']}"}
resp = requests.post(f"{API}/generations", headers=HEADERS, json={
"model": "minimax-h3",
"input": {
"prompt": "A breakdancer spins on one hand in an empty car park at dusk, the camera circling low around him. Sneakers squeak on concrete, a beat echoes from a speaker.",
"resolution": "2K",
"duration": 10,
"aspect_ratio": "16:9",
},
"max_cost_usd": 0.5,
})
resp.raise_for_status()
job = resp.json()
while job["status"] in ("queued", "running"):
time.sleep(5)
job = requests.get(f"{API}/generations/{job['id']}", headers=HEADERS).json()
if job["status"] == "succeeded":
print(job["output"]["urls"], job["cost_usd"])
else:
print("Failed:", job["error"])// Node 18 or later. Save as generate.mjs and run: node generate.mjs
const API = "https://api.revana.si/v1";
const headers = {
Authorization: `Bearer ${process.env.REVANA_API_KEY}`,
"Content-Type": "application/json",
};
const res = await fetch(`${API}/generations`, {
method: "POST",
headers,
body: JSON.stringify({
model: "minimax-h3",
input: {
prompt: "A breakdancer spins on one hand in an empty car park at dusk, the camera circling low around him. Sneakers squeak on concrete, a beat echoes from a speaker.",
resolution: "2K",
duration: 10,
aspect_ratio: "16:9",
},
max_cost_usd: 0.5,
}),
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
let job = await res.json();
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 5000));
job = await (await fetch(`${API}/generations/${job.id}`, { headers })).json();
}
if (job.status === "succeeded") console.log(job.output.urls, job.cost_usd);
else console.error("Failed:", job.error);{
"id": "gen_01JC2V8K5T",
"model": "minimax-h3",
"status": "succeeded",
"output": {
"urls": [
"https://cdn.revana.si/g/gen_01JC2V8K5T/0.mp4"
],
"duration_s": 10,
"has_audio": true
},
"cost_usd": 0.4,
"attempts": 1,
"error": null,
"created_at": "2026-10-28T10:14:02Z",
"completed_at": "2026-10-28T10:15:31Z"
}Hailuo 2.3 Fast로 이미지 움직이게 하기
이미지 투 비디오는 시작 프레임을 image_url에 보내고 움직임을 설명하세요. 이 6초 768p 클립은 $0.24입니다.
{
"model": "hailuo-2.3-fast",
"input": {
"prompt": "The dancer leaps and lands in a low crouch, her skirt swirling, the camera pushing in.",
"image_url": "https://example.com/dancer.jpg",
"resolution": "768p",
"duration": 6
},
"max_cost_usd": 0.3
}모델이 지원하지 않는 길이나 해상도는 422 invalid_input로 즉시 거부되며, 메시지에 지원되는 값이 나열됩니다. 거부된 요청과 실패한 작업에는 요금이 청구되지 않습니다.
모든 Hailuo 및 MiniMax 모델은 모델 페이지에 있습니다. 필드별 상세 내용은 문서에, 크레딧 팩은 요금 페이지에 있으며, API 키를 받아 샘플을 실행해 보세요.
자주 묻는 질문
Hailuo API는 얼마인가요?
2026년 10월 기준 Hailuo 2.3은 768p에서 초당 $0.06, 1080p에서 $0.09입니다. Hailuo 2.3 Fast는 768p에서 $0.04입니다. Hailuo 02는 512p에서 초당 $0.02부터 시작합니다.
MiniMax H3란 무엇인가요?
MiniMax의 최신 영상 모델입니다. 텍스트, 시작 이미지, 첫·마지막 프레임, 최대 9장의 참조 이미지로 소리가 있는 4~15초 클립을 768p 또는 2K로 만들며, 초당 $0.03부터 시작합니다.
Hailuo로 텍스트 투 비디오를 만들 수 있나요?
Hailuo 2.3, Hailuo 02, Hailuo 02 Pro는 가능합니다. Hailuo 2.3 Fast와 Hailuo 2.3 Standard는 이미지 투 비디오만 지원합니다.
Hailuo 영상은 얼마나 길게 만들 수 있나요?
Hailuo 2.3은 6초 또는 10초 클립, Hailuo 02는 5초 또는 10초 클립을 만들며, 1080p에서는 6초를 기준으로 계획하세요. MiniMax H3는 4~15초를 지원합니다.
MiniMax H3는 소리를 생성하나요?
네, 항상 생성합니다. 소리는 영상과 함께 생성되며 가격은 같으므로 audio 필드는 생략하세요.