비디오 공식 파트너

Hailuo 03 (MiniMax H3) API

MiniMax H3으로 오디오가 동기화된 768p / 네이티브 2K 비디오를 하나의 통합 API에서 생성하세요. 이미지·클립·음성 샘플을 레퍼런스로 전달할 수 있고, 출력 초 단위로 과금됩니다. 비동기 작업과 웹훅을 지원하며 별도의 MiniMax 계정을 관리할 필요가 없습니다.

API 키 받기 문서 읽기

2K
최대 해상도: 15s
최대 클립 길이: ~285s
평균 생성 시간: 10 credits/s
최저 가격

비디오 · 예시

플레이그라운드

Hailuo 03 (MiniMax H3), 지금 바로 사용해 보세요.

model: hailuo-03

프롬프트

화면 비율 길이 Resolution

미디어 입력

Reference image End image Upgrade 768p clip to 2K Reference images Reference videos Reference audio

예상 비용 80–128 크레딧 · $0.80–$1.28 Studio에서 생성

출력

출력이 여기에 표시됩니다. 생성을 누르면 Studio에서 이 요청이 실행됩니다.

요금

단순한 초당 과금.

10–16 크레딧 / 출력 1초당 ≈ $0.10–$0.16

요금은 선택한 해상도와 옵션에 따라 달라집니다.

9초 클립은 90–144 크레딧(≈ $0.90–$1.44)입니다.

성공한 생성에 대해서만 비용을 지불합니다. 실패한 작업은 자동으로 환불됩니다.
Apiframe의 모든 모델에서 하나의 크레딧 잔액을 사용합니다. 모델별 요금제가 없습니다.
무료 크레딧으로 시작하세요. 구독이 필요 없습니다.
대용량 플랜에는 볼륨 할인이 적용됩니다.

요금제와 크레딧 팩 보기

스펙

한눈에 보기.

공급업체 MiniMax

모델 ID hailuo-03

화면 비율 16:9, 21:9, 4:3, 1:1, 3:4, 9:16, auto

해상도 768p, 2K

길이 4초, 5초, 6초, 7초, 8초, 9초, 10초, 11초, 12초, 13초, 14초, 15초

이미지 입력 지원

오디오 지원

평균 시간 ~285초

빠른 시작

Hailuo 03 (MiniMax H3) API 호출 방법.

API 키와 함께 POST /v2/videos/generate 요청 하나만 보내세요. 호출은 폴링할 수 있는 jobId를 반환하며, webhook_url을 전달하면 결과가 준비되는 즉시 푸시됩니다.

모델 값 hailuo-03만 다른 모델로 바꾸면 나머지는 그대로입니다.

API 키 받기 문서 읽기

generate.js

const response = await fetch("https://api.apiframe.ai/v2/videos/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
    "model": "hailuo-03",
    "hailuoParams": {
      "resolution": "2K",
      "image": "https://example.com/input.jpg",
      "end_image": "https://example.com/input.jpg",
      "base_video": "https://example.com/input.jpg"
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

import requests

response = requests.post(
    "https://api.apiframe.ai/v2/videos/generate",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
        "model": "hailuo-03",
        "hailuoParams": {
            "resolution": "2K",
            "image": "https://example.com/input.jpg",
            "end_image": "https://example.com/input.jpg",
            "base_video": "https://example.com/input.jpg"
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

curl -X POST https://api.apiframe.ai/v2/videos/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
        "model": "hailuo-03",
        "hailuoParams": {
            "resolution": "2K",
            "image": "https://example.com/input.jpg",
            "end_image": "https://example.com/input.jpg",
            "base_video": "https://example.com/input.jpg"
        }
    }'

let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"

입력 스키마

Hailuo 03 (MiniMax H3) 모델이 받는 모든 필드와 타입, 기본값입니다. 전체 레퍼런스는 문서에 있습니다.

필드	타입	설명
prompt 필수	string	생성할 내용에 대한 텍스트 설명.
model 필수	string	이 엔드포인트의 모델 식별자. 기본값:"hailuo-03" · "hailuo-03"
hailuoParams.resolution	string	Resolution 기본값:"2K" · "2K", "768p"
hailuoParams.image	string (URL)	Use a still as the first frame.
hailuoParams.end_image	string (URL)	Optional last frame to control the ending.
hailuoParams.base_video	string (URL)	A 768p Hailuo 03 clip to regenerate at 2K. Output is always 2K.
hailuoParams.reference_images	string[] (URLs)	First 5 are included; extra images are billed per image.
hailuoParams.reference_videos	string[] (URLs)	15s total across all clips. Billed per second, like the output.
hailuoParams.reference_audios	string[] (URLs)	Voice timbre reference. Needs at least one reference image or video.