Hailuo 02 API
엔드 프레임을 지원하는 Hailuo 02.
Hailuo 02을(를) 단 한 번의 API 호출로 통합하세요. 하나의 키, 하나의 통합 엔드포인트, 그리고 Apiframe의 모든 모델에 적용되는 통합 청구.
model: "hailuo-02" Hailuo 02의 특별한 점
- 768p / 1080p(으)로 출력.
- 6초에서 10초까지의 클립을 생성.
- 이미지→비디오 및 참조 이미지 지원.
- 빠른 처리 — 생성당 평균 약 180초.
- MiniMax 계정 없이 사용한 만큼 지불. 성공한 생성에 대해서만 비용을 지불합니다.
- Apiframe의 모든 모델에서 하나의 API 키, 통합 청구, 멱등성, 웹훅을 지원.
Hailuo 02(으)로 제작
Apiframe의 Hailuo 02 API로 생성한 출력 예시입니다.
Drone shot flying over a tropical coastline at sunrise, smooth cinematic motion
A vintage car driving through a rainy neon city at night, reflections on the asphalt
Time-lapse of clouds rolling over a mountain range in warm golden light
개요
- 엔드포인트
- POST /v2/videos/generate
- 모델 ID
- hailuo-02
- 파라미터 키
- hailuoParams
- 모달리티
- 비디오
- 제공업체
- MiniMax
- 평균 완료 시간
- ~180s
기능
빠른 시작
API 키와 함께 POST /v2/videos/generate 요청을 한 번 보내면 Hailuo 02로 생성이 시작됩니다. 응답으로 폴링하거나 웹훅으로 받을 수 있는 jobId가 반환됩니다.
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
}
}'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" }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);응답 및 작업 수명 주기
생성은 비동기로 처리됩니다. 제출이 성공하면 202 Accepted와 jobId가 반환됩니다. 상태가 COMPLETED가 될 때까지 GET /v2/jobs/{id}를 폴링하거나 webhook_url을 지정하면 result 필드에 출력 URL이 담깁니다.
1. 제출 응답 (202)
{
"jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
"status": "QUEUED"
}2. 결과 폴링
curl https://api.apiframe.ai/v2/jobs/JOB_ID \
-H "X-API-Key: afk_your_api_key_here"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"])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);입력 스키마
Hailuo 02 엔드포인트가 허용하는 요청 파라미터입니다. 모델별 옵션은 아래에 표시된 파라미터 객체 안에 중첩됩니다.
| 파라미터 | 유형 | 필수 | 기본값 | 허용값 / 범위 | 설명 |
|---|---|---|---|---|---|
| prompt | string | 필수 | — | — | 생성할 내용에 대한 텍스트 설명. |
| model | string | 필수 | "hailuo-02" | "hailuo-02" | 이 엔드포인트의 모델 식별자. |
| hailuoParams.image | string (URL) | 선택 | — | — | Use a still as the first frame. |
| hailuoParams.resolution | string | 선택 | "768p" | "768p", "1080p" | Resolution |
| hailuoParams.end_image | string (URL) | 선택 | — | — | Optional last frame to control the ending. |
| hailuoParams.prompt_optimizer | boolean | 선택 | true | — | Let Hailuo rewrite your prompt for better results. |
자주 묻는 질문
Hailuo 02 API에 대한 일반적인 질문입니다.
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개의 모델별 파라미터를 허용합니다. 유형과 기본값을 포함한 전체 목록은 위의 입력 스키마를 참고하세요.
아직 궁금한 점이 있으신가요?
Hailuo 02 API로 개발을 시작하세요
API 키를 받아 몇 분 만에 Hailuo 02을(를) 통합하세요 — 사용한 만큼 지불.
궁금하신 점이 있으신가요? Discord에 참여하거나 영업팀에 문의하세요.