Hailuo 02란 무엇이며 이전 버전과 어떻게 다른가요?

Hailuo 02는 MiniMax의 2세대 영상 모델입니다. 일관된 캐릭터 렌더링과 물리적으로 정확한 모션으로 시네마틱 1080p 클립을 출력합니다. Pro 티어는 프롬프트 방향에 대한 충실도가 더 높으며, Standard는 더 빠른 생성과 낮은 비용을 제공합니다.

이미지를 시작 프레임으로 사용할 수 있나요?

네. image_to_video 엔드포인트를 사용하고 first_frame_image_url을 전달하세요. Hailuo는 해당 프레임에서 순방향 모션을 생성하므로, 영상이 정확히 이미지에서 시작하여 거기서부터 애니메이션이 생성됩니다.

Hailuo 생성에는 얼마나 걸리나요?

6초 1080p 클립의 경우 일반적으로 30~90초가 소요됩니다. 많은 병렬 작업을 실행 중인 경우, 큐 지연으로 몇 초가 추가될 수 있습니다. 상태 엔드포인트는 실시간 상태를 반영합니다 — 5~10초마다 폴링하세요.

OPENCLAW + HAILUO

OpenClaw에서 Hailuo를 사용하세요.

MiniMax의 Hailuo 02는 텍스트 또는 이미지로부터 1080p의 6초 영상을 생성합니다 — 시네마틱 카메라 워크, 일관된 캐릭터 렌더링, 부드러운 모션. OpenClaw 에이전트는 채팅에 사용하는 것과 동일한 RunAPI key로 호출합니다.

API Key 받기 문서 읽기

하나의 API key · 텍스트-비디오 + 이미지-비디오 · 1080p 출력

Use RunAPI to generate a video with MiniMax Hailuo 02 Pro.

Requirements:
- Call the RunAPI text_to_video endpoint at https://runapi.ai/api/v1/hailuo/text_to_video
- Set model to "hailuo-02-text-to-video-pro"
- Use the RUNAPI_API_KEY environment variable for authorization
- Include a detailed prompt describing camera movement and scene
- The response is async — poll the task status endpoint until the task completes, then retrieve the video URL

curl -X POST https://runapi.ai/api/v1/hailuo/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-02-text-to-video-pro",
    "prompt": "A glass marble rolls across a wooden desk, catches the edge, and falls in slow motion. Camera follows the marble. Soft window light, shallow depth of field."
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "hailuo-02-text-to-video-pro"
}

curl 명령어를 복사하여 테스트하세요 hailuo

작동 방식

OpenClaw에서 Hailuo를 세 단계로 사용하기

RunAPI 설정

환경에 RUNAPI_API_KEY를 설정하세요. RunAPI가 이미 OpenClaw 채팅 프로바이더라면, 동일한 key로 Hailuo 영상도 지원됩니다 — 추가 설정이 필요 없습니다.

export RUNAPI_API_KEY=runapi_xxx

Hailuo text_to_video 호출

/api/v1/hailuo/text_to_video에 model을 hailuo-02-text-to-video-pro와 프롬프트로 POST 요청을 보내세요. 이미지-비디오의 경우, /api/v1/hailuo/image_to_video를 사용하고 first_frame_image_url을 포함하세요.

POST /api/v1/hailuo/text_to_video

결과 가져오기

엔드포인트는 task_id를 반환합니다. 상태가 completed가 될 때까지 폴링한 후 영상 URL을 가져오세요. 6초 1080p 클립 생성에는 일반적으로 30~90초가 소요됩니다.

GET /api/v1/hailuo/text_to_video/tsk_abc123

파라미터

Hailuo text_to_video 파라미터

파라미터	유형	설명
`model`	`string`	필수. hailuo-02-text-to-video-pro 또는 hailuo-02-text-to-video-standard.
`prompt`	`string`	장면 설명. 이미지-비디오 모드를 사용하지 않는 경우 필수.
`first_frame_image_url`	`string`	이미지-비디오 모드를 위한 첫 번째 프레임 이미지 URL.
`last_frame_image_url`	`string`	선택 사항. 마지막 프레임으로 사용할 이미지의 URL. Hailuo 02 image-to-video에서만 사용 가능.
`duration_seconds`	`integer`	선택 사항. 영상 길이(초). 허용 값: 6 또는 10. standard에서 기본값은 10, pro에서는 고정.
`output_resolution`	`string`	출력 화면 비율. 허용 값: 16:9, 9:16, 1:1.
`callback_url`	`string`	선택 사항. 작업 완료 시 POST를 수신하는 웹훅 URL.

OpenClaw의 Hailuo란?

MiniMax의 Hailuo는 동급 최속 동영상 생성 속도로 네이티브 1080p 영상을 부드러운 움직임과 뛰어난 디테일 유지로 제작합니다. Hailuo 2.3을 통해 애니메이션과 스타일화된 콘텐츠용 전용 렌더링 모드를 제공합니다. OpenClaw agent는 RunAPI를 통해 채팅과 동일한 API 키로 호출합니다.