> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# ComfyUI에서 MiniMax H3 API 비디오 생성
> ComfyUI에서 MiniMax H3 API 노드를 클라우드 워크플로와 함께 사용하는 방법을 알아보세요. 텍스트 기반 비디오 생성, 첫/마지막 프레임 기반 비디오 생성, 레퍼런스 기반 비디오 생성 모두 네이티브 스테레오 오디오를 지원합니다.
[MiniMax H3](https://www.minimax.io/blog/minimax-h3)은(는) MiniMax의 일반 목적 옴니모달 생성 모델로, ComfyUI에서 MiniMax H3 API 노드를 통해 사용할 수 있습니다. API 워크플로는 MiniMax 서버에서 생성 작업을 실행하므로 모델 다운로드나 로컬 GPU가 필요하지 않으며, 생성된 비디오의 각 초는 Comfy API 계정에 청구됩니다.
MiniMax H3는 **네이티브 스테레오 오디오**로 비디오를 생성합니다. 음성, 사운드 효과, 음악은 이후에 레이어링되는 대신 단일 정방향 패스에서 함께 모델링됩니다. 출력은 클립당 5\~15초, 최대 2K 해상도입니다.
이 API 워크플로는 Comfy 계정을 통해 MiniMax 서버에서 실행됩니다. 상업 작업을 위해 자체 하드웨어에서 H3를 로컬로 실행하려면 [MiniMax 상업 라이선스](https://comfy.org/minimax/license)가 필요합니다. 이 라이선스는 유일한 공식 리셀러인 Comfy를 통해 제공됩니다.
## MiniMax H3가 뛰어난 분야
* **네이티브 스테레오 오디오**: 음성, 사운드 효과, 음악이 비디오와 함께 단일 포워드 패스로 모델링되며, 이후에 덧입혀지지 않습니다
* **고해상도 출력**: 클립당 5\~15초, 최대 2K 해상도
* **텍스트 기반 비디오 생성**: 텍스트 프롬프트에서 오디오를 포함한 비디오를 생성합니다
* **첫 번째-마지막 프레임 비디오**: 첫 번째 프레임과 선택적인 마지막 프레임 이미지 사이의 모션을 생성합니다
* **참조 조건 생성**: 최대 9개의 참조 이미지, 3개의 참조 비디오, 3개의 참조 오디오 클립을 조건으로 비디오를 생성합니다
## 출력 예시
단일 프롬프트에서 텍스트 기반 비디오 생성(기본 스테레오 오디오 포함):
첫 번째-마지막 프레임 생성(모델이 두 프레임 사이의 움직임 생성):
파트너 노드를 사용하려면 올바르게 로그인되어 있고 허가된 네트워크 환경을 사용하고 있는지 확인해야 합니다. 파트너 노드를 사용하기 위한 구체적인 요구사항은 문서의 [파트너 노드 개요](/ko/tutorials/partner-nodes/overview) 섹션을 참조해 주세요.
ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.
* [ComfyUI 다운로드](https://www.comfy.org/download)
* [업데이트 가이드](/ko/installation/update_comfyui)
이 가이드의 워크플로는 [워크플로 템플릿](/ko/interface/features/template)에서 확인할 수 있습니다.
템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다.
워크플로를 로드할 때 노드가 누락되는 경우, 가능한 원인:
1. 최신 ComfyUI 버전(최신 테스트 버전(nightly))을 사용하고 있지 않음
2. 일부 노드가 시작 시 가져오기에 실패함
* [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.
따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.
## MiniMax H3 API 워크플로
템플릿 라이브러리에는 세 가지 API 예제 워크플로가 포함되어 있습니다:
* **텍스트 기반 비디오 생성**: 텍스트 프롬프트에서 비디오를 생성합니다.
* **첫/마지막 프레임 기반 비디오 생성**: 첫 번째 프레임 이미지와 마지막 프레임 이미지 사이의 비디오를 생성합니다.
* **레퍼런스 기반 비디오 생성**: 레퍼런스 이미지, 비디오 및 오디오를 조건으로 비디오를 생성합니다.
### MiniMax H3 텍스트 기반 비디오 생성
MiniMax H3 API를 통해 텍스트 프롬프트에서 비디오를 생성할 수 있으며, 스테레오 오디오를 기본 지원합니다.
Comfy Cloud에서 열기
JSON 다운로드 또는 템플릿 라이브러리에서 "MiniMax H3 T2V" 검색
#### 프롬프트 팁
1. **프롬프트**: 전체 장면과 그에 따른 오디오(대화, SFX, 음악)를 한 블록에 설명하세요.
2. **재생 시간**: 재생 시간 입력은 5\~15초를 지원하며, 워크플로에는 빠른 5초 미리보기가 포함되어 있습니다.
3. **해상도 및 비율**: API는 2K로 렌더링합니다. `16:9`, `9:16`, `1:1` 등의 화면 비율 프리셋을 선택하세요.
4. **워터마크**: AIGC 워터마크는 기본적으로 꺼져 있습니다. 필요한 경우 노드의 고급 설정에서 활성화하세요.
#### 프롬프트 작성 가이드
MiniMax는 기본 생성 모드인 T2VA, I2VA, FL2VA, L2VA에 대한 공식 [비디오 프롬프트 작성 가이드](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_base_en.md)를 게시합니다. 이 가이드는 카메라 움직임과 오디오(대화, SFX, 음악)가 포함된 시간별 샷으로 프롬프트를 구성하는 방법을 설명하고, 각 모드에 대한 예제를 포함합니다.
### MiniMax H3 첫/마지막 프레임 기반 비디오 생성
MiniMax H3 API를 사용하여 첫 프레임과 선택 사항인 마지막 프레임 이미지 사이의 비디오를 생성합니다. 출력의 가로세로 비율은 입력 이미지를 따릅니다.
Comfy Cloud에서 열기
JSON을 다운로드하거나 템플릿 라이브러리에서 "MiniMax H3 FLF2V"를 검색하세요.
워크플로에서 사용할 첫 프레임입니다. 직접 준비한 이미지를 사용해도 됩니다.
워크플로에서 사용할 마지막 프레임입니다. 직접 준비한 이미지를 사용해도 됩니다.
#### 프롬프트 팁
1. **프레임**: `first_frame` 입력은 필수이고 `last_frame`은 선택 사항입니다. 모델은 두 프레임 사이의 움직임을 생성합니다.
2. **가로세로 비율**: 출력은 입력 이미지를 따르므로 두 프레임을 동일한 가로세로 비율로 유지하세요.
3. **이미지 제약 조건**: 각 프레임의 너비와 높이는 256픽셀에서 5760픽셀 사이여야 하며, 가로세로 비율은 2:5에서 5:2 사이여야 합니다.
4. **프롬프트**: 프레임 사이의 전환과 원하는 오디오(대사, 효과음, 음악)를 설명하세요.
#### 프롬프트 작성 가이드
MiniMax는 기본 생성 모드인 T2VA, I2VA, FL2VA, L2VA를 위한 공식 [비디오 프롬프트 작성 가이드](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_base_en.md)를 제공합니다. 이 가이드는 카메라 움직임과 오디오(대사, 효과음, 음악)가 포함된 시간대별 샷으로 프롬프트를 구성하는 방법을 설명하며, 각 모드에 대한 예시도 포함합니다.
### MiniMax H3 레퍼런스 기반 비디오 생성
MiniMax H3 API를 통해 레퍼런스 이미지, 비디오, 오디오를 조건으로 비디오를 생성합니다.
Comfy Cloud에서 열기
JSON 다운로드 또는 템플릿 라이브러리에서 "MiniMax H3 R2V" 검색
워크플로용 스토리보드 레퍼런스입니다. 또는 직접 만든 이미지를 사용하세요.
#### 프롬프트 팁
1. **태그로 레퍼런스 지정**: 프롬프트에서 각 입력을 순서대로 참조하세요. 예: `Image 1`, `Video 1`, `Audio 1`
2. **제한 사항**: 최대 9개의 레퍼런스 이미지, 3개의 레퍼런스 비디오, 3개의 레퍼런스 오디오 클립을 사용할 수 있습니다. 각 비디오 또는 오디오 클립은 2\~15초여야 하며, 레퍼런스 비디오와 오디오의 총 길이는 각각 15초로 제한됩니다.
3. **오디오에는 시각적 앵커가 필요합니다**: 레퍼런스 오디오는 최소 한 개의 레퍼런스 이미지 또는 비디오가 없으면 사용할 수 없습니다.
4. **비디오 요구 사항**: 레퍼런스 비디오는 23.976\~60 FPS여야 합니다.
5. **프롬프트**: 각 레퍼런스에 작업(정체성, 스타일, 모션, 음성)을 할당하고 목표 샷을 설명하세요. 명시적인 할당이 훨씬 더 잘 작동하는 경향이 있습니다.
#### 프롬프트 작성 가이드
MiniMax는 레퍼런스 기반 생성(R2V)을 위한 공식 [전체 레퍼런스 모드 프롬프트 가이드](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_ref_en.md)를 게시합니다. 이 가이드는 재작성 출력 구조(피사체 정의, 레퍼런스 라벨, 보존 분석 포함)와 각 레퍼런스에 대상 샷에서의 역할을 할당하는 방법을 다룹니다.