MiniMax Hailuo 02 사용법：완벽 가이드

MiniMax Hailuo 02는 화면, 움직임, 효과를 정밀하게 제어하면서 영화 같은 품질의 영상을 만들 수 있는 강력한 AI 모델입니다. APIMart에서 MiniMax Hailuo 02 API로 사용할 수 있으며, 텍스트-투-비디오, 이미지-투-비디오, 첫/마지막 프레임 전환을 지원해 최대 1080p의 짧은 고품질 클립을 만들 수 있습니다. 알아야 할 내용은 다음과 같습니다.

• 주요 기능: 텍스트 프롬프트, 첫 프레임 이미지, 또는 첫/마지막 프레임 이미지 쌍으로 영상을 만들고, 카메라 움직임은 프롬프트 안에서 직접 설명합니다.
• 가격: 2026년 10월 기준 APIMart의 1080p 클립은 초당 $0.08입니다. 현재 가격은 모델 페이지에서 확인하세요.
• 설정: API 키를 발급하고, 파라미터로 요청을 구성한 뒤, 비동기 폴링으로 영상을 가져옵니다.
• 활용 분야: 광고, 제품 쇼케이스, 스토리보드, 교육 영상에 이상적입니다.

시작하려면 APIMart 계정을 만들고 API 키를 안전하게 보관한 다음, 아래 단계별 가이드를 따라 영상을 생성하세요. 구체적인 프롬프트와 명확한 카메라 지시를 쓰면 영상 품질을 최대한 끌어올릴 수 있습니다. 더 긴 프로젝트라면 일관된 프레임으로 여러 클립을 이어 붙이거나, 다른 시네마틱 생성 방식으로 Kling V3 API를 살펴보세요.

핵심 요약

• MiniMax Hailuo 02는 APIMart에서 모델 ID MiniMax-Hailuo-02로 텍스트-투-비디오, 이미지-투-비디오, 첫 프레임에서 마지막 프레임으로의 전환 클립을 최대 1080p로 생성합니다.
• 워크플로는 APIMart 계정을 만들고, API Key Management에서 한 번만 표시되는 키를 발급하고, JSON 본문을 https://api.apimart.ai/v1/videos/generations로 POST한 뒤, 상태가 completed가 될 때까지 15–30초마다 /v1/tasks/{task_id}를 폴링하는 순서입니다.
• 주요 파라미터는 prompt, 5초 또는 10초의 duration, 512p·768p·1080p의 resolution, 공개 URL이나 Base64로 전달하는 first_frame_image와 last_frame_image, 기본값이 true인 prompt_optimizer입니다.
• 2026년 10월 기준 APIMart 가격은 512p 초당 $0.0104, 768p 초당 $0.04, 1080p 초당 $0.08입니다. 완성된 영상은 data.result.videos[0].url[0]에서 읽고, 결과는 72시간 보관되므로 빨리 저장하세요.
• APIMart에서 1080p는 5초 클립만 지원하며 네이티브 오디오는 없습니다. 10초보다 긴 영상은 마지막 프레임을 다음 first_frame_image로 이어 붙입니다.

MiniMax Hailuo 02 한눈에 보기

APIMart에서 MiniMax Hailuo 02 시작하기

계정 설정과 API 키 발급

먼저 apimart.ai에 접속해 계정을 만듭니다. 팀 단위로 일한다면 APIMart에서 조직(organization) 을 만들 수 있습니다. 모두가 하나의 중앙 잔액을 공유하므로 개인 자격 증명을 주고받을 필요 없이 협업이 쉬워집니다.

계정이 준비되면 공유 잔액을 충전하세요. 이 잔액은 APIMart의 모든 모델에서 사용할 수 있으며, 전문가급 영상 생성을 위한 Veo 3.1 API 같은 하이엔드 모델도 포함됩니다. 다음으로 콘솔 대시보드의 API Key Management 섹션에서 API 키를 발급하세요.

기억할 점: API 키는 한 번만 표시됩니다. 반드시 복사해서 비밀번호 관리자나 시크릿 볼트처럼 안전한 곳에 보관하세요. 코드에서 키를 사용할 때는 직접 하드코딩하지 말고 환경 변수(예: APIMART_API_KEY)에서 불러오세요. 코드가 공유되거나 버전 관리 시스템에 업로드될 때 실수로 노출될 위험을 줄일 수 있습니다. 모든 API 요청에는 이 키가 authorization 헤더에 포함됩니다.

Authorization: Bearer YOUR_API_KEY

팀이라면 Organizations 기능으로 접근 권한을 중앙에서 관리할 수 있어 개인 계정 자격 증명을 공유할 필요가 없습니다 ^[2]. API 키가 준비되면 요청 파라미터를 설정하고 영상 생성을 시작할 수 있습니다. 다른 고품질 결과물을 원한다면 Grok Imagine Video API도 살펴보세요.

MiniMax Hailuo 02 요청의 주요 파라미터

API 키를 확보했다면 올바른 파라미터로 요청을 구성해야 합니다. "model": "MiniMax-Hailuo-02" 필드는 필수이며, 그 밖에도 몇 가지 파라미터가 있습니다. 가장 중요한 것들은 다음과 같습니다.

중요한 점이 하나 있습니다. 영상 생성은 비동기입니다. 요청을 보내면 API는 영상 자체가 아니라 task_id를 반환합니다. 상태가 "completed"로 바뀔 때까지 15–30초마다 /v1/tasks/{task_id}를 폴링해야 합니다. 완성되면 바로 다운로드하세요. 결과는 72시간 동안 보관됩니다 ^[1].

파라미터를 갖췄다면 MiniMax Hailuo 02를 충분히 활용할 수 있는 효과적인 프롬프트 작성에 집중하면 됩니다.

효과적인 프롬프트 작성법

좋은 프롬프트는 고품질 영상을 만드는 핵심입니다. 잘 구성된 프롬프트에는 카메라 샷 또는 움직임, 피사체와 설명, 동작, 장면, 조명, 스타일 또는 분위기의 여섯 가지 요소가 들어갑니다. 예를 들어 "도시를 걷는 여성" 처럼 막연하게 쓰기보다 "트래킹 샷: 빨간 코트를 입은 여성이 해 질 녘 비에 젖은 맨해튼 거리를 빠르게 걷고, 젖은 보도에 네온사인이 비치는 시네마틱 누아르 스타일" 처럼 구체적으로 써 보세요.

영상에 역동성을 주려면 프롬프트 맨 앞에 "천천히 푸시 인", "트래킹 샷", "고정 샷"처럼 카메라 움직임을 평이한 말로 설명하세요. APIMart의 Hailuo 02 문서에는 대괄호 카메라 명령 목록이 없습니다. 이 가이드 뒷부분에서 다루는 15가지 대괄호 중국어 카메라 명령은 Hailuo 2.3 문서에 나온 것입니다.

복잡한 장면을 다룰 때는 prompt_optimizer를 true로 두세요. 이 기능이 설명을 자동으로 다듬고 확장해 주기 때문에, 큰 노력 없이도 더 매끄럽고 일관된 영상을 얻는 경우가 많습니다 ^[1].

Hailuo 02에서 영화 같은 AI 영상을 만드는 법

단계별 가이드: MiniMax Hailuo 02로 영상 생성하기

기본 텍스트-투-비디오 API 요청 보내기

API 키와 프롬프트가 준비되었다면 첫 요청을 보내는 것은 간단합니다. https://api.apimart.ai/v1/videos/generations로 POST 요청을 보내면 됩니다. 헤더에 Bearer Token을 넣고 다음과 같은 JSON 본문을 사용하세요.

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "Tracking shot: a lone astronaut walks across a red desert at golden hour, dust swirling around their boots, cinematic wide-angle style.",
  "duration": 5,
  "resolution": "1080p"
}

중요: 1080p 해상도는 5초 클립만 지원합니다. 10초 영상을 원한다면 해상도를 768p나 512p로 낮춰야 합니다. 가격은 해상도와 길이에 따라 달라집니다. 2026년 10월 기준 768p는 초당 $0.04, 1080p는 초당 $0.08이며, 현재 요금은 모델 페이지에서 확인하세요.

요청을 제출하면 API는 data[0].task_id에 task_id를 반환하고 상태는 submitted가 됩니다. 렌더링 시간은 해상도, 길이, 현재 부하에 따라 달라지므로 작업이 끝날 때까지 계속 폴링하세요.

이미지-투-비디오 기능 사용법

이미지-투-비디오 요청에는 first_frame_image라는 파라미터를 추가해야 합니다. 공개 URL(예: https://example.com/start.jpg)이나 Base64로 인코딩된 Data URL 문자열 모두 사용할 수 있습니다. 이미지가 지정된 파일 형식, 크기, 화면비 요구 사항을 충족하는지 확인하세요.

이미지가 이미 장면의 시각적 맥락을 제공하므로, 프롬프트에는 장면의 시각적 세부 사항이 아니라 움직임을 설명해야 합니다. 예를 들어 시작 이미지가 테이블 위의 제품이라면 "Slow zoom in. Product rotates gently, soft studio lighting, clean white background" 같은 프롬프트로 모델에게 어떻게 움직일지 알려 줍니다. 출력 해상도는 입력 이미지의 크기에 맞춰지므로, 선명한 결과를 얻으려면 고품질 원본을 쓰는 것이 필수입니다.

더 고급 효과를 원한다면 first_frame_image와 함께 last_frame_image를 넣을 수 있습니다. 두 이미지 사이를 잇는 전환 영상이 만들어지며, 제품 공개, 비포·애프터 비교, 큰 프로젝트의 장면 전환 등에 딱 맞습니다.

요청을 설정했다면 API 응답을 확인해 애니메이션 영상을 가져오세요. 오디오가 통합되어야 하는 프로젝트라면 동기화된 사운드 생성을 지원하는 Veo 3.1 API도 고려해 보세요.

API 응답 읽기와 결과물 다운로드

GET https://api.apimart.ai/v1/tasks/{task_id}를 폴링합니다. 작업 상태가 completed로 바뀌면 영상 URL은 data.result.videos[0].url[0]에 있습니다. 별도의 파일 ID나 다운로드 엔드포인트는 없습니다. 상태 흐름은 다음과 같습니다.

상태가 completed로 바뀔 때까지 15–30초마다 /v1/tasks/{task_id} 엔드포인트를 폴링하세요. 완료되면 반환된 URL에서 영상을 다운로드합니다. 결과는 72시간 보관되므로 빨리 자체 스토리지에 저장하세요 ^[1].

Python을 쓴다면 requests.get(video_url).content로 영상을 다운로드해 .mp4 파일로 저장할 수 있습니다. 여기서 video_url은 작업 응답의 data["result"]["videos"][0]["url"][0]입니다.

마지막으로 API 응답의 code 필드는 항상 확인하세요. 200은 요청이 성공했다는 뜻이지만, 렌더링 오류가 생길 수 있으므로 작업 상태를 계속 모니터링해야 합니다 ^[1].

영상 품질 향상과 워크플로 통합

프롬프트와 파라미터 설정 다듬기

영상 품질을 높이려면 [피사체와 동작], [물리적/환경적 요소], [카메라 움직임], [조명/분위기], [품질 표현] 형식으로 프롬프트를 구성해 보세요 ^[7]. 예시: "바리스타가 에스프레소에 김이 나는 우유를 붓고, 액체가 슬로 모션으로 소용돌이치며, 천천히 줌 인, 따뜻한 카페 조명, 시네마틱 품질." 이런 방식은 모델이 사실적인 움직임과 분위기를 더 효과적으로 구현하도록 돕습니다.

명시적인 카메라 태그가 필요하다면, APIMart의 MiniMax Hailuo 2.3 API은 15가지 대괄호 중국어 카메라 명령을 지원합니다. 정확한 라벨 그대로 프롬프트 맨 앞에 넣으면 됩니다 ^[3]. 빠르게 참고할 수 있도록 표로 정리했습니다.

prompt_optimizer 기능은 기본으로 켜져 있으며, 대체로 출력 품질을 높여 줍니다. 아주 구체적인 스크립트를 그대로 따라야 하는 경우가 아니라면 켜 두세요. 속도가 우선이고 다듬어진 정도가 조금 떨어져도 괜찮다면 fast_pretreatment: true로 전처리 시간을 줄일 수 있습니다 ^[1][6].

프롬프트와 설정이 다듬어지면 더 큰 파이프라인에 통합해 제작 품질을 끌어올리세요.

APIMart로 멀티 모델 파이프라인 구축하기

Hailuo 02는 오디오와 긴 시퀀스를 보완하는 도구와 함께 쓸 때 가장 좋은 결과를 냅니다. 물, 불, 천처럼 시각적으로 역동적인 B롤 영상을 만드는 데 뛰어나지만, 오디오는 생성하지 않습니다. 이 빈틈을 메우려면 후반 작업에서 MiniMax Audio 도구, 예를 들어 내레이션용 Speech 2.8이나 배경 음악용 Music 2.6을 함께 사용하세요 ^[8]. 브랜드나 상업 프로젝트라면 이미지 모델로 기본 프레임을 먼저 만든 뒤, 그것을 Hailuo 02의 first_frame_image로 넣어 구도를 정밀하게 제어할 수 있습니다 ^[7].

10초보다 긴 영상이라면, 완성된 클립의 마지막 프레임을 캡처해 다음 요청의 first_frame_image로 사용하세요. 이렇게 하면 여러 클립에 걸쳐 캐릭터 디테일과 환경 조명을 일관되게 유지하기 쉬워집니다 ^[8].

오류 처리와 API 모범 사례

프롬프트와 파이프라인을 다듬어도 문제는 생길 수 있습니다. 다음 모범 사례를 따라 문제를 해결하고 API 응답을 효과적으로 최적화하세요.

Hailuo 02에서 가장 흔한 실패는 지원하지 않는 해상도/길이 조합과 잘못된 이미지 입력 두 가지입니다. 해상도와 길이 설정이 호환되는지 항상 확인하세요 ^[1][6]. 이미지-투-비디오 작업의 경우, MiniMax 자체 문서는 원본 이미지를 20MB 미만, 짧은 변 300px 초과, 화면비 2:5~5:2, JPG·PNG·WebP 형식으로 준비할 것을 권장합니다 ^[5].

작업이 실패하면 항상 작업 응답의 error 필드를 확인하세요. 문제를 빠르게 해결할 수 있는 세부 정보가 담겨 있습니다. 프로덕션 환경에서는 폴링 간격을 적당히 유지하고 지수 백오프로 재시도하세요. 불필요한 API 호출을 줄이고 워크플로의 응답성을 유지할 수 있습니다.

결론: 핵심 요약

MiniMax Hailuo 02가 영상 생성 도구로서 돋보이는 이유를 빠르게 정리해 보겠습니다.

MiniMax Hailuo 02는 놀라운 정밀도로 영화 같은 품질의 영상 제작을 제공합니다. NCR 아키텍처 덕분에 이전 모델 대비 파라미터는 3배, 학습 데이터는 4배로 늘어났으며 ^[7], 물, 불, 연기, 천 같은 복잡한 요소를 매우 사실적으로 표현합니다.

2026년 10월 기준 APIMart에서 768p는 초당 $0.04, 1080p는 초당 $0.08이며 ^[2], 전문 제작부터 창작 실험까지 실용적인 선택이 됩니다.

이 모델의 대표 기능은 다음과 같습니다.

• 정밀한 제어를 위한 이미지-투-비디오 도구
• 전문가다운 촬영 효과를 위한 프롬프트 수준의 카메라 지시(예: "트래킹 샷", "천천히 줌 인")
• 긴 시퀀스에서도 매끄러운 전환을 보장하는 마지막 프레임 연속성

참고로 APIMart에서 1080p 클립은 5초로 제한됩니다(MiniMax 발표에는 6초로 나와 있습니다). 더 긴 영상에는 768p가 좋은 대안이며, 더 낮은 가격으로 10초 클립을 만들 수 있습니다 ^[1].

이런 기능들 덕분에 MiniMax Hailuo 02는 영상 제작 워크플로를 한 단계 끌어올릴 준비가 되어 있습니다.

FAQ

10초보다 긴 클립은 어떻게 만드나요?

MiniMax Hailuo 02의 클립 최대 길이는 10초이며, 10초 클립에는 768p 또는 512p가 필요합니다(1080p는 5초만 지원). 더 긴 영상이 필요하다면 10초 클립을 여러 개 생성하고, 앞 클립의 마지막 프레임을 다음 클립의 first_frame_image로 써서 이어 붙이세요.

10초 텍스트-투-비디오 클립이라면 요청에 다음 파라미터를 넣으세요.

• duration: 10
• resolution: "768p"
• model: "MiniMax-Hailuo-02"

요청을 제출한 뒤 상태가 completed가 될 때까지 작업을 폴링하고, data.result.videos[0].url[0]에서 영상을 다운로드하세요.

작업이 실패하면 어떻게 해야 하나요?

영상 생성 작업이 성공하지 못했다면 먼저 HTTP 상태와 응답의 error 객체를 확인해 원인을 찾으세요. 흔한 경우는 다음과 같습니다.

• 400: 지원하지 않는 해상도와 길이 조합 같은 잘못된 파라미터
• 401: API 키 인증 문제
• 402: 계정 잔액 부족
• 429: 요청 제한에 도달

요청 제한 오류(HTTP 429)나 서버 관련 문제(HTTP 5xx)에는 _지수 백오프_를 적용해 보세요. 재시도할 때마다 대기 시간을 점점 늘리는 방식입니다. 또한 입력 파라미터를 다시 확인하고, 검증 오류를 피하기 위해 프롬프트에 민감한 내용이 없도록 하세요.

클립 간에 캐릭터를 일관되게 유지하려면?

MiniMax Hailuo 02에서 캐릭터 일관성을 유지하려면, 각 클립을 선명하고 조명이 좋은 캐릭터 first_frame_image로 시작하고, 앞 클립의 마지막 프레임을 다음 클립의 첫 프레임으로 재사용하세요. 여러 클립을 작업한다면 프롬프트에 같은 조명 디테일을 넣으세요. 시각적 흐름을 더 매끄럽게 하려면 샷 간 카메라 앵글을 맞추고, 후반 작업에서 크로스페이드나 매치 컷 같은 은은한 전환도 고려해 보세요. 이런 기법들이 일관되고 완성도 높은 이야기를 만드는 데 도움이 됩니다.