하나의 API key
모델과 제공사를 넘나들며 같은 인증 정보를 사용합니다.
curl -X POST https://runapi.ai/api/v1/hailuo/image_to_video \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo-2.3-image-to-video-standard",
"first_frame_image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
"prompt": "나무 책상 위를 굴러가다가 가장자리에서 떨어지는 유리 구슬의 6초짜리 클립을 생성해 주세요."
}'import { HailuoClient } from "@runapi.ai/hailuo";
const client = new HailuoClient();
const result = await client.imageToVideo.run({
model: "hailuo-2.3-image-to-video-standard",
first_frame_image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "나무 책상 위를 굴러가다가 가장자리에서 떨어지는 유리 구슬의 6초짜리 클립을 생성해 주세요.",
});<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\Hailuo\HailuoClient;
$client = new HailuoClient();
$result = $client->imageToVideo->run([
'model' => 'hailuo-2.3-image-to-video-standard',
'first_frame_image_url' => 'https://cdn.runapi.ai/public/samples/image.jpg',
'prompt' => '나무 책상 위를 굴러가다가 가장자리에서 떨어지는 유리 구슬의 6초짜리 클립을 생성해 주세요.',
]);require "runapi/hailuo"
client = RunApi::Hailuo::Client.new
result = client.image_to_video.run(
model: "hailuo-2.3-image-to-video-standard",
first_frame_image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "나무 책상 위를 굴러가다가 가장자리에서 떨어지는 유리 구슬의 6초짜리 클립을 생성해 주세요."
)npx skills add runapi-ai/hailuo -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor개요
Hailuo 소개
Hailuo는 사실적인 물리 시뮬레이션으로 네이티브 1080p 영상을 생성할 수 있는 MiniMax의 비디오 생성 모델입니다. 표준 및 pro 품질 티어에서 텍스트-비디오와 이미지-비디오 생성을 모두 지원합니다.
제공사
MiniMax
모달리티
비디오
변형
요금
Hailuo 요금
| endpoint | 해상도 | 길이 | 가격 | |
|---|---|---|---|---|
| image_to_video | — | — | $0.39 / 비디오 |
hailuo-02-image-to-video-pro 기준 요금입니다. 다른 변형은 각자의 endpoint 요금이 적용됩니다.
에이전트 통합
에이전트에서 Hailuo 실행
작동 방식
Hailuo 시작하기
-
모델 선택
출력 유형, 품질 기준, 지연 시간 목표에 맞는 모델과 변형을 고릅니다.
-
한 번 인증
모든 지원 모델에 RunAPI key를 사용합니다.
-
skill 설치
기능을 구현하기 전에 코딩 워크스페이스에 model skill을 추가합니다.
-
결과 받기
task ID로 조회하거나 생성 완료 시 callback을 처리합니다.
RunAPI로 Hailuo을 쓰는 이유
Skill-ready
model skill에 schema, 설정 메모, 가격 컨텍스트, 모델 ID가 포함됩니다.
예측 가능한 과금
호출 전에 사용량 기반 가격을 확인할 수 있습니다.
Hailuo FAQ
Hailuo의 출력 해상도는 어떻게 되나요?
pro 변형에서 네이티브 1080p를 출력합니다. 표준 변형은 최대 768p를 출력하며, Hailuo 2.3 표준은 1080p에 도달합니다. pro 티어는 후처리 업스케일링이 필요 없습니다.
생성된 클립의 길이는 얼마나 되나요?
텍스트-비디오와 이미지-비디오 엔드포인트 모두 생성당 최대 10초입니다.
물리 시뮬레이션은 얼마나 사실적인가요?
Hailuo는 정확한 물리를 위해 특별히 훈련되었습니다 — 유체 역학, 물체 충돌, 중력, 천 움직임이 높은 충실도로 렌더링됩니다.
표준과 pro의 차이는 무엇인가요?
Pro는 더 나은 디테일과 모션 충실도를 갖춘 네이티브 1080p를 출력합니다. 표준은 최대 768p를 출력하며(Hailuo 2.3 standard는 1080p에 도달).
Hailuo 2.3이 02보다 개선된 점이 있나요?
네 — 2.3은 개선된 신체 움직임, 미세 표정, 그리고 02 세대에서는 사용할 수 없었던 전용 애니메이션/일러스트 스타일을 추가합니다.
이 모델은 어떻게 호출하나요?
model skill을 설치하고 RunAPI key와 함께 설정 메모를 따르세요.
유사 모델