> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/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가 필요하지 않으며, 생성된 비디오는 1초마다 Comfy API 계정으로 청구됩니다.

MiniMax H3는 **네이티브 스테레오 오디오**와 함께 비디오를 생성합니다. 음성, 사운드 효과, 음악이 이후에 레이어링되는 대신 단일 포워드 패스에서 함께 모델링됩니다. 출력 해상도는 최대 2K이며 클립당 5\~15초 길이입니다.

<Tip>
  파트너 노드를 사용하려면 올바르게 로그인되어 있고 허가된 네트워크 환경을 사용하고 있는지 확인해야 합니다. 파트너 노드를 사용하기 위한 구체적인 요구사항은 문서의 [파트너 노드 개요](/ko/tutorials/partner-nodes/overview) 섹션을 참조해 주세요.
</Tip>

<Tip>
  <Tabs>
    <Tab title="로컬 사용자">
      ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.

      * [ComfyUI 다운로드](https://www.comfy.org/download)
      * [업데이트 가이드](/ko/installation/update_comfyui)

      이 가이드의 워크플로우는 [워크플로우 템플릿](/ko/interface/features/template)에서 확인할 수 있습니다.
      템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다.

      워크플로우를 로드할 때 노드가 누락되는 경우, 가능한 원인:

      1. 최신 ComfyUI 버전(야간 빌드)을 사용하고 있지 않음
      2. 일부 노드가 시작 시 가져오기에 실패함
    </Tab>

    <Tab title="클라우드 사용자">
      * [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.

      따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.
    </Tab>
  </Tabs>
</Tip>

## MiniMax H3 API 워크플로

템플릿 라이브러리에는 세 가지 API 예제 워크플로가 포함되어 있습니다.

* **텍스트 기반 비디오 생성**: 텍스트 프롬프트에서 비디오를 생성합니다.
* **첫/마지막 프레임 기반 비디오 생성**: 첫 프레임과 마지막 프레임 이미지 사이의 비디오를 생성합니다.
* **레퍼런스 기반 비디오 생성**: 레퍼런스 이미지, 비디오, 오디오를 조건으로 비디오를 생성합니다.

### MiniMax H3 텍스트 기반 비디오 생성

MiniMax H3 API를 통해 텍스트 프롬프트에서 비디오를 생성하며, 네이티브 스테레오 오디오를 지원합니다.

<video controls className="w-full aspect-video" src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_minimax_h3_t2v.mp4" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_minimax_h3_t2v&utm_source=docs&utm_medium=referral&utm_campaign=minimax-h3-api">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_minimax_h3_t2v.json">
    JSON 다운로드 또는 템플릿 라이브러리에서 "MiniMax H3 T2V" 검색
  </Card>
</CardGroup>

#### 프롬프트 팁

1. **프롬프트**: 전체 장면과 함께 포함될 오디오(대화, 효과음, 음악)를 한 블록에 설명하세요.
2. **재생 시간**: 재생 시간 입력은 5\~15초를 지원합니다. 워크플로에는 빠른 5초 미리보기가 포함되어 있습니다.
3. **해상도 및 비율**: API는 2K로 렌더링합니다. `16:9`, `9:16`, `1:1` 같은 화면 비율 프리셋을 선택하세요.
4. **워터마크**: AIGC 워터마크는 기본적으로 꺼져 있습니다. 필요한 경우 노드의 고급 설정에서 활성화하세요.

### MiniMax H3 첫/마지막 프레임 기반 비디오 생성

MiniMax H3 API를 통해 첫 프레임과 선택 사항인 마지막 프레임 이미지 사이의 비디오를 생성합니다. 출력의 화면 비율은 입력 이미지를 따릅니다.

<video controls className="w-full aspect-video" src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_minimax_h3_flf2v.mp4" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_minimax_h3_flf2v&utm_source=docs&utm_medium=referral&utm_campaign=minimax-h3-api">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_minimax_h3_flf2v.json">
    JSON 다운로드 또는 템플릿 라이브러리에서 "MiniMax H3 FLF2V" 검색
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="첫 프레임: angel-warrior-demon-battle-start.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/angel-warrior-demon-battle-start.png">
    워크플로의 첫 프레임이거나, 직접 만든 이미지를 사용하세요.
  </Card>

  <Card title="마지막 프레임: angel-warrior-demon-battle-end.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/angel-warrior-demon-battle-end.png">
    워크플로의 마지막 프레임이거나, 직접 만든 이미지를 사용하세요.
  </Card>
</CardGroup>

#### 프롬프트 팁

1. **프레임**: `first_frame` 입력은 필수이고, `last_frame`은 선택 사항입니다. 모델은 두 프레임 사이의 움직임을 생성합니다.
2. **화면 비율**: 출력이 입력 이미지를 따르므로 두 프레임 모두 동일한 화면 비율로 유지하세요.
3. **이미지 제약 사항**: 각 프레임의 너비와 높이는 256\~5760픽셀 사이여야 하며 화면 비율은 2:5에서 5:2 사이여야 합니다.
4. **프롬프트**: 프레임 사이의 전환과 원하는 오디오(대화, 효과음, 음악)를 설명하세요.

### MiniMax H3 레퍼런스 기반 비디오 생성

MiniMax H3 API를 통해 레퍼런스 이미지, 비디오, 오디오를 조건으로 비디오를 생성합니다.

![MiniMax H3 레퍼런스 기반 비디오 생성 워크플로 미리보기](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_minimax_h3_r2v-1.webp)

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_minimax_h3_r2v&utm_source=docs&utm_medium=referral&utm_campaign=minimax-h3-api">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_minimax_h3_r2v.json">
    JSON 다운로드 또는 템플릿 라이브러리에서 "MiniMax H3 R2V" 검색
  </Card>
</CardGroup>

<CardGroup cols={1}>
  <Card title="레퍼런스 이미지: 9panel_storyboard_golden_hour_clay_court.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/9panel_storyboard_golden_hour_clay_court.png">
    워크플로의 스토리보드 레퍼런스이거나, 직접 만든 이미지를 사용하세요.
  </Card>
</CardGroup>

#### 프롬프트 팁

1. **태그로 레퍼런스 지정**: 프롬프트에서 각 입력을 순서로 참조하세요. 예: `Image 1`, `Video 1`, `Audio 1`.
2. **제한 사항**: 레퍼런스 이미지 최대 9개, 레퍼런스 비디오 3개, 레퍼런스 오디오 클립 3개까지 사용할 수 있습니다. 각 비디오 또는 오디오 클립은 2\~15초여야 하며, 레퍼런스 비디오와 오디오는 각각 총 15초로 제한됩니다.
3. **오디오에는 시각적 앵커 필요**: 레퍼런스 오디오는 최소 한 개의 레퍼런스 이미지 또는 비디오 없이는 사용할 수 없습니다.
4. **비디오 요구 사항**: 레퍼런스 비디오는 23.976\~60 FPS여야 합니다.
5. **프롬프트**: 각 레퍼런스에 역할(정체성, 스타일, 움직임, 음성)을 지정하고 대상 샷을 설명하세요. 명시적인 역할 지정이 훨씬 더 잘 작동하는 경향이 있습니다.
