MiniMax H3 사용법: 오픈 웨이트와 API

MiniMax H3는 H3-Base 오픈 웨이트 또는 MiniMax가 제공하는 호스팅 API를 통해 사용할 수 있습니다. 자체 호스팅 환경에서 추론을 실행하고 모델 수준의 제어가 필요하다면 오픈 웨이트가 적합합니다. 모델 서버를 운영하지 않고 앱이나 자동화 워크플로에서 생성하려면 API가 적합합니다.

어떤 경로가 가장 좋은지는 어느 작업까지 직접 책임지고 운영할지에 따라 달라집니다. 이 가이드에서는 현재 이용 가능한 두 가지 방법의 시작 절차와 동일한 조건으로 비교하는 테스트 방법을 설명합니다.

오픈 웨이트와 API: 어떤 H3 이용 경로를 선택해야 할까요?

모델 파일을 직접 관리하는 인프라에서 실행해야 한다면 오픈 웨이트를 선택하세요. 연구, 맞춤형 추론 코드, 로컬 파이프라인 실험에도 적합합니다.

GPU 인프라를 유지하지 않고 기능을 출시하거나 배치 작업을 자동화하거나 H3를 테스트하려면 MiniMax API를 선택하세요. 다만 각 생성 작업을 처리하는 주변 워크플로는 직접 구축해야 합니다.

두 경로가 모두 요구 사항을 충족한다면 API부터 시작하는 것이 현실적입니다. 개발팀이 작동하는 H3 요청을 만드는 가장 짧은 경로인 경우가 많기 때문입니다. 자체 호스팅으로만 해결할 수 있는 구체적인 요구 사항이 있을 때 오픈 웨이트로 전환하세요.

오픈 웨이트로 H3-Base를 실행하는 방법

MiniMax는 H3-Base 체크포인트를 두 가지 계열로 공개했습니다. FL2VA는 텍스트 생성과 시작 프레임, 종료 프레임 또는 두 프레임을 이용한 유도에 대응합니다. Ref2VA는 참조 이미지, 영상, 선택 사항인 오디오를 사용해 결과를 유도합니다.

공개된 것은 더 큰 H3 시스템 중 Base 단계뿐입니다. H3-Base는 오디오가 포함된 768p 영상을 생성합니다. MiniMax가 호스팅하는 Context-IR 및 Regenerate-2K 구성 요소는 현재 오픈 웨이트 패키지에 포함되어 있지 않습니다.

파일을 다운로드하기 전에 체크포인트를 선택하세요

실제로 사용할 입력에 맞춰 체크포인트를 선택합니다.

Ref2VA가 더 고급으로 보인다는 이유만으로 선택하지 마세요. 텍스트와 시작·종료 프레임 작업에는 FL2VA가 직접 대응합니다. Ref2VA는 다른 입력 워크플로를 위한 체크포인트입니다.

맞춤형 구성 요소를 추가하기 전에 로컬 워크플로 하나를 완성하세요

1. 라이선스와 모델 카드를 읽으세요.사용 목적, 지역, 배포 계획, 소속 조직이 공개된 조건에 부합하는지 확인합니다.
2. 지원되는 추론 방법 하나를 선택하세요.MiniMax는 H3 공식 저장소에서 SGLang, vLLM, Diffusers, ComfyUI를 안내합니다.
3. 용도에 맞는 체크포인트와 필수 구성 요소를 다운로드하세요.FL2VA와 Ref2VA 파일은 명확히 구분해 보관합니다.
4. 선택한 실행 환경의 공식 설정 절차를 따르세요.첫 번째 성공 결과를 만든 소프트웨어 버전을 고정합니다.
5. 간단한 작업 하나를 실행하세요.프롬프트, 입력, 워크플로, 지원되는 경우 시드, 출력을 저장합니다.
6. 자원 사용량을 기록하세요.자체 하드웨어의 시작 시간, 최대 VRAM, 생성 시간, 스토리지 사용량, 실패 내용을 기록합니다.

커뮤니티 노드, 어댑터, 양자화 변경, 복잡한 참조 자료를 처음부터 한꺼번에 추가하지 마세요. 첫 실행이 실패했을 때 변수가 너무 많으면 원인을 찾기 어렵습니다.

로컬 운영으로 제어할 수 있는 것과 없는 것

자체 호스팅을 사용하면 모델 제공 환경, 주변 코드, 파일 처리, 호환되는 추론 설정을 제어할 수 있습니다. 자체 전처리와 검토 파이프라인도 구축할 수 있습니다.

그러나 이런 제어를 추가해도 H3-Base가 완전한 호스팅 시스템으로 바뀌지는 않습니다. 맞춤형 전처리기는 MiniMax의 Context-IR 구현이 아니며, 별도의 업스케일러도 공식 Regenerate-2K 단계와는 다릅니다.

로컬 배포에서는 비용과 책임도 이용자에게 넘어옵니다. 컴퓨팅 자원, 스토리지, 개발 시간, 모니터링, 안전 조치, 실패한 실행까지 고려해야 합니다. 개인정보 보호 수준은 로그, 접근 규칙, 자산 저장 방식, 타사 구성 요소에 따라 달라집니다.

API로 MiniMax H3를 사용하는 방법

API를 사용하면 모델을 직접 호스팅할 필요는 없지만, 애플리케이션 작업까지 사라지는 것은 아닙니다. H3 생성은 비동기 작업으로 실행됩니다. 작업을 생성하고 ID를 저장한 뒤 상태를 확인하고, 완료된 출력을 가져와야 합니다.

최소 API 수명 주기부터 시작하세요

1. MiniMax 플랫폼 계정과 API 키를 만드세요.키는 클라이언트 측 코드와 공개 저장소 밖의 안전한 위치에 보관합니다.
2. 입력 패턴 하나를 선택하세요.여러 참조 자료를 추가하기 전에 텍스트 또는 이미지 한 장을 중심으로 한 요청부터 시작합니다.
3. 영상 생성 작업을 만드세요.모델에 MiniMax-H3를 지정하고 비어 있지 않은 프롬프트를 포함합니다.
4. 반환된 작업 ID를 저장하세요.사용자, 입력 파일, 요청 설정과 연결합니다.
5. 작업 상태 엔드포인트를 폴링하세요.진행 중, 성공, 실패 상태를 각각 처리합니다.
6. 결과를 가져와 저장하세요.반환된 위치를 영구 저장소로 간주하지 말고, 직접 관리하는 스토리지에 출력을 다운로드합니다.

현재 요청 필드와 엔드포인트 세부 정보는 MiniMax의 공식 영상 생성 가이드에서 확인하세요. 타사 튜토리얼의 오래된 페이로드를 복사하지 말고 최신 스키마를 사용합니다.

첫 요청이 성공하면 프로덕션 안전장치를 추가하세요

요청 하나가 처음부터 끝까지 완료되면 다음 제어 기능을 추가합니다.

• 유료 작업을 제출하기 전에 프롬프트와 미디어를 검증합니다.
• 사용자가 새로 고치거나 다시 시도할 때 중복 제출을 방지합니다.
• 폴링 간격과 최대 대기 시간 정책을 설정합니다.
• 요청 오류와 생성 실패를 구분합니다.
• 중단된 세션에서 작업을 복구할 수 있도록 작업 ID를 저장합니다.
• 실패한 시도와 사용 가능한 결과 한 건당 최종 비용을 추적합니다.
• 접근, 검토, 보관, 삭제에 관한 자체 규칙을 적용합니다.

실패한 작업 하나를 안정적으로 복구할 수 있기 전에는 동시 실행 수를 늘리지 마세요. 성공적인 API 호출은 신뢰할 수 있는 사용자 워크플로를 만드는 첫 단계일 뿐입니다.

작은 H3 테스트 하나로 두 경로를 비교하세요

공정하게 비교하려면 같은 소스, 프롬프트, 목표, 합격 기준을 사용해야 합니다. 첫 테스트는 짧고 시각적으로 단순하게 구성하세요.

반복해서 사용할 수 있는 테스트 카드

참조 이미지: 나무 테이블 위에 무광 흰색 도자기 머그잔이 놓인 16:9 이미지입니다. 이용 허가를 받은 이미지를 사용하고, 손잡이와 인쇄된 라벨이 선명하게 보여야 합니다.

프롬프트:

입력 이미지의 머그잔, 손잡이, 라벨, 테이블, 배경을 유지한다. 카메라가 한 번 천천히 앞으로 이동하는 동안 머그잔에서 김이 서서히 올라온다. 라벨은 읽을 수 있는 상태를 유지한다. 오디오에는 조용한 실내 배경음과 도자기가 가볍게 부딪히는 소리를 한 번 포함한다. 음악은 넣지 않는다.

합격 기준:

• 머그잔의 형태와 손잡이가 안정적으로 유지됩니다.
• 인쇄된 라벨을 읽을 수 있습니다.
• 컵 디자인이 바뀌지 않은 채 김이 움직입니다.
• 여러 카메라 움직임 대신 천천히 앞으로 이동하는 움직임이 한 번만 사용됩니다.
• 실내 배경음과 도자기가 가볍게 부딪히는 소리가 한 번 포함됩니다.
• 음악이 포함되지 않습니다.

두 경로에서 공통으로 지원하는 설정 중 가장 가까운 길이와 화면비를 사용하세요. 한 경로에서 같은 설정을 선택할 수 없다면 창작 목표를 바꾸지 말고 차이를 기록합니다.

렌더링 시간뿐 아니라 결과도 기록하세요

로컬 실행에서는 하드웨어, 실행 환경, 소프트웨어 버전, 정밀도 또는 양자화, 최대 VRAM, 체크포인트 출처도 기록합니다. API 실행에서는 작업 상태, 응답 오류, 스토리지 동작을 기록합니다.

한 번의 결과만으로 어느 경로가 항상 더 빠르거나 우수하다고 증명할 수는 없습니다. 다만 현재 팀, 인프라, 실패를 감수할 수 있는 범위에 맞는 경로를 판단하는 데 도움이 됩니다.

자주 발생하는 설정 문제를 해결하세요

로컬 워크플로가 로드되지 않습니다

체크포인트와 워크플로가 일치하는지 확인하세요. 그런 다음 파일 이름, 위치, 종속성 버전을 공식 저장소와 비교합니다. 기본 워크플로가 실행될 때까지 타사 노드와 최적화를 제거하세요.

API가 요청을 받았지만 앱에서 결과를 찾을 수 없습니다

MiniMax가 작업 ID를 반환하면 즉시 영구 저장하세요. 새로 고침이나 일시적인 연결 장애 후에도 인터페이스에서 상태 확인을 재개할 수 있어야 합니다. 완료된 미디어는 자체 스토리지로 복사하세요.

출력이 프롬프트의 일부를 따르지 않습니다

테스트를 피사체 하나, 동작 하나, 카메라 움직임 하나, 오디오 목표 하나로 줄이세요. 작은 버전이 성공한 뒤에만 복잡도를 높입니다. 참조 기반 생성에서는 모든 소스가 모든 요소를 제어하도록 하지 말고, 각 소스의 역할을 명확히 정하세요.

로컬과 API 결과가 일치하지 않습니다

먼저 실제 입력, 체크포인트 또는 모델 이름, 길이, 해상도, 프롬프트, 추론 설정을 비교하세요. 공개 H3-Base와 호스팅 서비스는 동일한 시스템 경로가 아니므로 결과가 정확히 같을 것으로 가정해서는 안 됩니다.

어떤 H3 이용 경로가 적합할까요?

소스 자산, 프롬프트, 합격 기준은 다른 환경에서도 다시 쓸 수 있는 형태로 보관하세요. 그러면 매번 크리에이티브 브리프를 다시 만들지 않고도 경로를 비교할 수 있습니다.

자주 묻는 질문

GPU 없이 MiniMax H3를 사용할 수 있나요?

네. GPU 인프라를 운영하고 싶지 않다면 MiniMax의 호스팅 API를 사용할 수 있습니다. 다만 작업을 생성하고, 상태를 확인하고, 결과를 저장하는 애플리케이션이나 스크립트는 필요합니다.

H3 오픈 웨이트와 호스팅 H3 서비스는 같은가요?

아닙니다. 공개 웨이트는 H3-Base FL2VA와 Ref2VA를 대상으로 합니다. 전체 시스템에는 현재 오픈 웨이트 패키지에 포함되지 않은 호스팅 Context-IR 및 Regenerate-2K 구성 요소도 사용됩니다.

로컬 H3-Base에서 공식 2K 결과 전체를 생성할 수 있나요?

아닙니다. 문서에 명시된 로컬 H3-Base 경로는 768p로 출력합니다. 공식 2K 경로에 사용되는 Regenerate-2K는 현재 공개 패키지에 포함되어 있지 않습니다.

FL2VA와 Ref2VA 중 무엇을 선택해야 하나요?

텍스트 생성이나 시작·종료 프레임을 고정하는 작업에는 FL2VA를 선택합니다. 이미지, 영상 또는 선택 사항인 오디오로 피사체의 일관성, 스타일, 움직임, 카메라, 음성, 소리를 유도하려면 Ref2VA를 선택합니다.

H3를 상업용 프로젝트에 사용할 수 있나요?

사용할 수 있는 경우도 있지만, 조건은 이용 경로와 상황에 따라 달라집니다. 오픈 웨이트에는 Community License가, 호스팅 서비스에는 최신 플랫폼 약관이 적용되므로 공개 전에 지역, 매출, 저작자 표시, 배포 및 용도 제한을 확인하세요.

MiniMax H3 이용 경로를 선택하세요

작동하는 결과를 빠르게 얻는 것이 중요하다면 API부터 시작하세요. 자체 호스팅이나 모델 수준 접근으로만 해결할 수 있는 구체적인 요구 사항이 있다면 오픈 웨이트를 선택하세요.

MiniMax H3는 곧 DomoAI에서 제공될 예정입니다. 이용할 수 있게 되면 소식을 알려드리겠습니다.