모델 가이드

Hailuo API: Hailuo 2.3, Hailuo 02, MiniMax H3

MiniMax는 두 가지 영상 계열을 판매합니다. 생동감 있는 움직임으로 알려진 Hailuo 모델과, 소리와 2K 출력을 지원하는 신형 MiniMax H3입니다. 이 가이드는 Revana의 모든 버전, 각각의 초당 비용, 호출 방법을 다룹니다.

하나의 API로 사용하는 Hailuo 및 MiniMax 영상 모델

Hailuo는 액션, 댄스, 신체 움직임 등 역동적인 모션으로 알려진 MiniMax의 영상 모델 계열입니다. MiniMax의 최신 영상 모델인 H3는 MiniMax 이름으로 판매됩니다. Revana는 두 계열을 같은 요청 형식으로 제공합니다.

Hailuo 및 MiniMax 영상 모델 비교
모델모델 id기능해상도길이시작가경로
Hailuo 2.3hailuo-2.3텍스트 투 비디오, 이미지 투 비디오768p, 1080p6초 또는 10초$0.06 / s경로 2개
Hailuo 2.3 Fasthailuo-2.3-fast이미지 투 비디오768p, 1080p6초 또는 10초$0.04 / s경로 1개
Hailuo 2.3 Standardhailuo-2.3-std이미지 투 비디오768p, 1080p6초 또는 10초$0.04 / s경로 1개
Hailuo 02hailuo-02텍스트 투 비디오, 이미지 투 비디오, 첫·마지막 프레임512p, 768p, 1080p5초 또는 10초$0.02 / s경로 2개
Hailuo 02 Prohailuo-02-pro텍스트 투 비디오, 이미지 투 비디오1080p6 s$0.06 / s경로 1개
MiniMax H3minimax-h3텍스트 투 비디오, 이미지 투 비디오, 첫·마지막 프레임, 참조 이미지, 소리 포함768p, 2K4~15초$0.03 / s경로 3개
MiniMax H3 Maxminimax-h3-max텍스트 투 비디오, 이미지 투 비디오, 참조 이미지480p, 768p, 1080p5~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초당 청구됩니다. 표는 표시된 요금과 각 설정의 일반적인 클립 비용을 보여 줍니다.

Hailuo 및 MiniMax의 초당 및 클립당 가격
모델해상도초당6초 클립10초 클립
Hailuo 2.3768p$0.06$0.36$0.60
Hailuo 2.31080p$0.09$0.546초만 가능
Hailuo 2.3 Fast768p$0.04$0.24$0.40
Hailuo 2.3 Fast1080p$0.06$0.366초만 가능
Hailuo 02768p$0.045 s: $0.20$0.40
MiniMax H3768p$0.03$0.18$0.30
MiniMax H32K$0.04$0.24$0.40
MiniMax H3 Max1080p$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입니다.

cURL
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"
Python
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.js
// 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 필드는 생략하세요.

하나의 키로 Hailuo와 MiniMax를 사용해 보세요

모든 Hailuo 및 MiniMax 모델과 그 밖의 모든 영상·이미지 모델을 하나의 API 키로. $10부터 시작하는 선불 크레딧이며, 전달된 클립에만 청구됩니다.