영상
MiniMax H3
영상
Ofrai에서 사용 — 채팅·이미지·영상을 한 스튜디오에서, 공용 크레딧으로.
예시 프롬프트
예시를 선택하면 프롬프트와 권장 설정이 위의 MiniMax H3 크리에이터에 입력됩니다.
사용 방법
세 단계로 MiniMax H3 사용하기
- 01
입력 준비
MiniMax H3을(를) 선택한 상태에서 프롬프트와 지원되는 참조 자료를 추가하세요.
- 02
출력 설정
생성 전에 화면 비율, 해상도와 사용 가능한 영상 옵션을 선택하세요.
- 03
생성하고 다듬기
결과를 확인하고 프롬프트나 설정을 조정한 뒤 같은 작업 공간에서 새 버전을 생성하세요.
이 엔드포인트를 설명하는 원본 문서 페이지의 제목은 MiniMax Hailuo H3 video generation이며, MiniMax-H3, MiniMax-H3-Max, MiniMax-H3-Max-Turbo라는 세 가지 모델 ID를 문서화하고 있습니다. H3 Video라는 네 번째 ID는 정의되어 있지 않으며, 이 페이지에서도 그런 ID를 만들어 내지 않습니다. 아래 내용은 문서에 명시된 Hailuo H3 동영상 요청 규약을 그대로 설명합니다.
기본 모델인 MiniMax-H3를 진입점으로 다루는 이유는 이 모델만 여전히 2K를 제공하고, 문서에 명시된 기본 해상도가 이 모델에 해당하며, Max 등급은 5초부터 시작하는 반면 이 모델은 4초까지 지원하기 때문입니다. 이 페이지에 도달할 때 본 이름이 Max 등급을 가리키더라도 매개변수는 여기에 문서화된 것과 동일하며, 요청에 보내는 해상도, 길이, 참조 미디어 값에 따라 작업을 렌더링하는 등급이 결정됩니다.
이 엔드포인트에 문서화된 내용과 그렇지 않은 내용
문서는 세 가지 모델 ID를 제공하는 하나의 동영상 생성 인터페이스를 설명합니다. 인터페이스가 세 개인 것도, 모델 ID가 네 개인 것도 아닙니다. 실질적으로는 요청 형식이 하나이며, 그 안에 넣는 값으로 등급을 선택한다고 이해하면 됩니다. 텍스트 기반 동영상 생성에는 미디어가 필요하지 않습니다. 역할을 지정하여 첨부한 이미지 한 장 또는 두 장은 프레임 모드를 구동합니다. 이미지 세 장에서 아홉 장은 통합 참조 모드를 구동하며, 이 모드는 Max-Turbo에서 사용할 수 없습니다. 따라서 MiniMax-H3 또는 MiniMax-H3-Max에서 유효한 요청도 Turbo ID에서는 거부됩니다.
그다음 길이와 해상도가 나머지 등급 조건을 결정합니다. 기본 등급은 4~15초와 2K 또는 768p를, 두 Max 등급은 5~15초와 480P 또는 768P를 지원합니다. 이 엔드포인트에는 mode 매개변수가 전혀 없습니다. 요청의 구성이 유일한 제어 수단이라는 뜻이므로 이 점은 분명히 알아 둘 필요가 있습니다.
기본 등급만 여전히 2K를 지원합니다
MiniMax-H3는 해상도로 2K와 768p를 허용하며, MiniMax-H3-Max와 MiniMax-H3-Max-Turbo는 480P와 768P를 허용합니다. 길이는 기본 등급이 4~15초, Max 등급이 5~15초입니다. 엔드포인트에 문서화된 기본 해상도는 2K 이므로, 해상도를 지정하지 않은 요청은 기본 등급의 최저 해상도가 아닌 최고 해상도로 처리됩니다. 이 기본값을 의식적으로 다뤄야 하는 이유는 기본값을 그대로 적용한 초안도 2K 초안이 되기 때문입니다. 기본 등급의 최소 길이가 4초라는 점은 또 다른 차이이며, 실무에서는 더 유용한 차이입니다.
4초는 짧은 전환 영상, 반복 재생 구간, 기존 시간 슬롯에 맞춰야 하는 컷에 자연스러운 길이지만, 상위 등급에서는 사용할 수 없습니다. 문서에서 중간 해상도를 표기할 때 등급에 따라 대소문자를 다르게 쓴다는 점도 유의하세요. MiniMax-H3는 768p, Max 등급은 768P 이므로, 표기를 통일하지 말고 정확한 토큰을 보내세요.
하나의 프롬프트, 세 가지 생성 모드
이 모델 제품군은 텍스트 기반 동영상 생성, 첫 프레임 및 마지막 프레임 이미지를 이용한 동영상 생성, 그리고 이미지·동영상·오디오 참조를 함께 사용하는 통합 모드를 지원합니다. 마지막 모드는 여러 종류의 자료를 사용하는 단일 모드이며, 각각 독립적으로 활성화하는 세 가지 기능이 아닙니다. 모드는 따로 선언하는 것이 아니라 입력으로 결정됩니다. 이미지가 없으면 텍스트 기반 동영상 생성, 역할이 지정된 이미지가 한 장 또는 두 장이면 프레임 모드, 이미지가 세 장 이상이면 통합 참조 모드입니다. 화면비 필드의 동작도 모드에 따라 달라지므로 이 구분을 확인할 수 있습니다.
텍스트 기반 동영상 생성에서는 기본값이 16:9이고 adaptive를 사용할 수 없습니다. 프레임 모드에서는 원본 이미지가 프레임을 결정하므로 화면비 필드가 완전히 무시됩니다. 통합 참조 모드에서는 기본값이 adaptive 이지만 명시적인 값도 허용합니다. 요청이 예상과 다르게 동작한다면 이 세 상태 중 어디에 해당하는지 확인하는 것으로 대부분의 경우를 해결할 수 있습니다.
이미지 수가 역할을 결정합니다
세 모델 ID 모두에서 사용자가 혼동하기 쉬운 동작입니다. 호환성 필드인 image_urls는 URL 배열을 받고, 배열의 길이에 따라 각 이미지의 용도를 결정합니다. 이미지가 한 장이면 첫 프레임, 두 장이면 순서대로 첫 프레임과 마지막 프레임, 세 장에서 아홉 장이면 참조 이미지가 되며, 참조 이미지는 MiniMax-H3와 MiniMax-H3-Max만 지원합니다. 최대 개수는 아홉 장입니다. 신규 연동에는 각 역할을 명시적으로 지정하는 image_with_roles 사용이 권장됩니다. 문서는 이미지의 용도가 모호해질 수 있으므로 두 필드를 함께 보내지 말라고 구체적으로 경고합니다.
여기서 기억할 일반 원칙은 현재 모드에서 이미지 역할이 중요하다면 시스템이 대신 추론하도록 두어서는 안 된다는 것입니다. 이미지 세 장을 담은 요청은 참조 요청이며, 이미지 한 장에 부가 이미지 두 장을 더한 요청이 아닙니다. 이를 다르게 취급하면 오류가 발생하기보다 잘못 만들어진 것처럼 보이는 결과물이 나옵니다.
제출하면 클립이 아니라 작업이 반환됩니다
호출은 비동기 방식이며 generation.task 객체를 반환합니다. 이것이 규약의 전부이며, 설계 시 고려할 결과가 세 가지 있습니다. 요청 자체에는 업로드 기능이 없으므로, 제출 시점에 참조 미디어가 이미 접근 가능한 URL로 존재해야 합니다. 응답을 결과물로 취급할 수 없으므로 연동에 폴링을 포함해야 합니다. 또한 비동기 인터페이스의 실패는 동기 인터페이스의 실패와 다르게 드러납니다. 요청이 접수된 뒤 나중에 작업이 실패하므로, 오류 처리는 응답뿐 아니라 상태 전환까지 다뤄야 합니다. 특별히 생소한 내용은 아니지만, 첫 번째 작업에서만 작동하는 연동과 열 번째 작업에서도 작동하는 연동을 가르는 요소들입니다.
7000자, 그리고 생략할 수 없는 하나의 필드
prompt는 필수이며 최대 7000자입니다. 문서에서 유용한 부분은 구성에 관한 지침입니다. 대상, 동작, 장면, 카메라, 스타일, 사운드 요구 사항을 그 순서대로 설명하세요. 통합 참조 모드에서는 대상을 설명하는 부분에 참조를 넣어야 하므로 문장 순서가 중요한 역할을 합니다. 카메라 움직임을 설명한 뒤에 언급한 참조는 배경 요소로 해석되는 경향이 있습니다. 7000자는 대부분의 숏에 필요한 분량보다 훨씬 많습니다. 이처럼 넉넉한 한도의 위험은 공간이 부족해지는 데 있지 않고, 그 공간을 다 쓰게 되는 데 있습니다. 같은 대상에 대해 서로 충돌하는 설명을 두 개 쓰면 결과가 풍부해지는 대신 흐려집니다.
대상은 한 번만 설명하고, 정체성은 참조가 유지하도록 하며, 카메라 설명은 별도 문장으로 작성하세요. 그러면 렌더링 결과가 잘못되었을 때 참조 문제인지 카메라 문제인지 진단할 수 있습니다.
자주 묻는 질문
- MiniMax H3 Video는 별도의 모델 ID 인가요?
- 문서에 따르면 그렇지 않습니다. 원본 페이지의 제목은 MiniMax Hailuo H3 video generation이며, MiniMax-H3, MiniMax-H3-Max, MiniMax-H3-Max-Turbo라는 세 가지 ID를 정의합니다. H3 Video라는 네 번째 ID는 없습니다. 요청의 해상도, 길이, 참조 미디어에 따라 등급이 결정됩니다.
- 기본 MiniMax-H3는 어떤 해상도와 길이를 허용하나요?
- 해상도는 2K 또는 768p이며, 엔드포인트에 문서화된 기본값은 2K입니다. 길이는 4~15초 사이의 정수 값입니다. 두 Max 등급은 480P 또는 768P와 5~15초를 허용하므로, 4초 요청은 기본 등급에서만 가능합니다.
- 첨부한 각 이미지는 어떻게 사용되나요?
- 호환성 필드를 사용하면 개수로 결정됩니다. 한 장은 첫 프레임, 두 장은 순서대로 첫 프레임과 마지막 프레임, 세 장에서 아홉 장은 참조 이미지가 됩니다. 참조 이미지는 기본 등급과 MiniMax-H3-Max가 지원하지만 Turbo는 지원하지 않습니다. 이미지는 최대 아홉 장까지 사용할 수 있습니다. image_with_roles로 역할을 명시적으로 지정하고, image_urls와 절대 함께 보내지 마세요.
- 첫 프레임을 제공할 때 9:16을 요청할 수 있나요?
- 아니요. 프레임 모드에서는 출력이 항상 입력 이미지에 맞춰지며 화면비는 무시됩니다. 텍스트 기반 동영상 생성에서는 adaptive를 사용할 수 없고 기본값은 16:9입니다. adaptive가 기본값이 되는 것은 통합 참조 모드뿐입니다. 즉, 어떤 입력이 있는지에 따라 화면비는 제약 조건이 되거나, 아무 효과가 없거나, 기본값으로 적용됩니다.
자주 묻는 질문
- 이 페이지에서 MiniMax H3을(를) 바로 사용할 수 있나요?
- 예. 위 크리에이터는 실제 Ofrai 스튜디오이며 MiniMax H3이(가) 기본으로 선택되어 있습니다.
- 완성된 결과는 어디에 저장되나요?
- 로그인한 사용자의 생성 결과는 Ofrai 라이브러리에 저장되어 다운로드하거나 다시 열 수 있습니다.
- MiniMax H3에는 어떤 프롬프트가 가장 잘 맞나요?
- 주제, 배경, 시각 스타일, 조명, 카메라 또는 움직임을 명확하게 설명하세요. 위 예시를 실용적인 시작점으로 사용할 수 있습니다.
- 생성 전에 예시 프롬프트를 수정할 수 있나요?
- 예. 예시를 불러온 뒤 문구, 화면 비율, 참조 자료와 기타 지원 설정을 변경할 수 있습니다.
관련 모델
MiniMax H3과 비슷한 창작 작업을 수행할 수 있는 다른 영상 모델을 비교해 보세요.
관련 가이드
도구
상업적 이용은 선택한 모델과 모델 약관에 따릅니다.





