비디오 공식 파트너

Hailuo 02 API

제공: MiniMax

엔드 프레임을 지원하는 Hailuo 02.

API 키 받기 문서 읽기

1080P
최대 해상도: 10s
최대 클립 길이: ~180s
평균 생성 시간: 46 credits
최저 가격

비디오 · Hailuo 2.3 생성 결과

A dancer performing a fast hip-hop routine, clean limb motion, studio lighting.

플레이그라운드

Hailuo 02, 지금 바로 사용해 보세요.

model: hailuo-02

프롬프트

길이 Resolution

미디어 입력

Reference image End image

고급 설정

Optimize prompt Let Hailuo rewrite your prompt for better results.

예상 비용 46–82 크레딧 · $0.46–$0.82 Studio에서 생성

출력 예시 · Hailuo 2.3

A dancer performing a fast hip-hop routine, clean limb motion, studio lighting.

요금

단순한 생성당 과금.

46–82 크레딧 / 생성 1회당 ≈ $0.46–$0.82

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

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

요금제와 크레딧 팩 보기

스펙

한눈에 보기.

공급업체 MiniMax

모델 ID hailuo-02

해상도 768p, 1080p

길이 6초, 10초

이미지 입력 지원

평균 시간 ~180초

빠른 시작

Hailuo 02 API 호출 방법.

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

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

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-02",
    "hailuoParams": {
      "image": "https://example.com/input.jpg",
      "resolution": "768p",
      "end_image": "https://example.com/input.jpg",
      "prompt_optimizer": true
    }
  }),
});
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-02",
        "hailuoParams": {
            "image": "https://example.com/input.jpg",
            "resolution": "768p",
            "end_image": "https://example.com/input.jpg",
            "prompt_optimizer": True
        }
    },
)
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-02",
        "hailuoParams": {
            "image": "https://example.com/input.jpg",
            "resolution": "768p",
            "end_image": "https://example.com/input.jpg",
            "prompt_optimizer": true
        }
    }'

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 02 모델이 받는 모든 필드와 타입, 기본값입니다. 전체 레퍼런스는 문서에 있습니다.

필드	타입	설명
prompt 필수	string	생성할 내용에 대한 텍스트 설명.
model 필수	string	이 엔드포인트의 모델 식별자. 기본값:"hailuo-02" · "hailuo-02"
hailuoParams.image	string (URL)	Use a still as the first frame.
hailuoParams.resolution	string	Resolution 기본값:"768p" · "768p", "1080p"
hailuoParams.end_image	string (URL)	Optional last frame to control the ending.
hailuoParams.prompt_optimizer	boolean	Let Hailuo rewrite your prompt for better results. 기본값:true

Hailuo 버전

Apiframe의 모든 Hailuo 비디오 모델. 파라미터 하나로 전환하세요.

Hailuo 02 관련 질문

Hailuo 02 도입 전에 팀들이 자주 묻는 질문입니다. 그 외 내용은 문서에 있습니다.

Hailuo 02 API가 있나요?

네. Apiframe는 단일 REST 엔드포인트(POST /v2/videos/generate, model: "hailuo-02")로 Hailuo 02을(를) 제공합니다. 지원되는 모든 모델에서 통합된 API, 키, 청구를 사용할 수 있으며 별도의 MiniMax 계정이 필요하지 않습니다.

Hailuo 02 API 비용은 얼마인가요?

Hailuo 02은(는) Apiframe에서 간단한 사용량 기반 과금을 사용하며, 성공한 생성에 대해서만 비용을 지불합니다. 요금제와 대량 할인은 가격 페이지를 참고하세요.

Hailuo 02 API는 어떻게 호출하나요?

X-API-Key와 model: "hailuo-02"을(를) 포함한 JSON 본문을 담아 /v2/videos/generate에 POST 요청을 보냅니다. 응답으로 반환되는 jobId를 GET /v2/jobs/{id}로 폴링하거나 웹훅으로 결과를 받습니다.

Hailuo 02은(는) 어떤 파라미터를 지원하나요?

Hailuo 02은(는) 공통 prompt, webhook_url 필드와 함께 hailuoParams 아래에 중첩된 4개의 모델별 파라미터를 허용합니다. 유형과 기본값을 포함한 전체 목록은 위의 입력 스키마를 참고하세요.