> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-2b9c2cf.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# HunyuanVideo 1.5

> 소비자용 GPU에서 고품질 비디오 생성을 위한 경량 83억 파라미터 모델인 HunyuanVideo 1.5를 사용하는 방법을 알아보세요.

[HunyuanVideo 1.5](https://github.com/Tencent/HunyuanVideo)는 텐센트의 Hunyuan팀이 개발한 경량 83억 파라미터 모델입니다. 이 모델은 소비자용 GPU(24GB VRAM)에서 플래그십 수준의 비디오 생성 성능을 제공하며, 품질을 저하시키지 않으면서 진입 장벽을 대폭 낮췄습니다.

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

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

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

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

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

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

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

## 모델 주요 특징

* **콤팩트한 강력함**: 대형 모델과 동등한 최고 수준의 성능을 소비자 하드웨어에서도 구현합니다.
* **다양한 생성 지원**: 뛰어난 일관성을 갖춘 고화질 텍스트 기반 비디오 생성 및 이미지 기반 비디오 생성(5\~10초)을 지원합니다.
* **정밀한 제어**: 카메라 움직임, 물리적 효과, 감정 표현에 대한 강력한 명령어 준수 기능을 제공합니다.
* **시네마틱 품질**: 기본 720p 출력(1080p까지 스케일링 가능)으로 전문적인 미학을 자랑합니다.
* **풍부한 기능**: 다양한 스타일(사실적, 애니메이션, 3D)과 비디오 내 텍스트 렌더링(중국어/영어)을 지원합니다.

## 모든 워크플로에 공통으로 사용하는 모델

다음 모델은 텍스트-투-비디오 및 이미지-투-비디오 워크플로 모두에서 사용됩니다. 다운로드하여 지정된 디렉터리에 저장하세요.

<CardGroup cols={2}>
  <Card title="Qwen2.5 VL 7B 다운로드" icon="download" href="https://huggingface.co/Comfy-Org/HunyuanVideo_1.5_repackaged/blob/main/split_files/text_encoders/qwen_2.5_vl_7b_fp8_scaled.safetensors?download=true">
    qwen\_2.5\_vl\_7b\_fp8\_scaled.safetensors. <code>ComfyUI/models/text\_encoders/</code>에 저장
  </Card>

  <Card title="ByT5 Small 다운로드" icon="download" href="https://huggingface.co/Comfy-Org/HunyuanVideo_1.5_repackaged/blob/main/split_files/text_encoders/byt5_small_glyphxl_fp16.safetensors?download=true">
    byt5\_small\_glyphxl\_fp16.safetensors. <code>ComfyUI/models/text\_encoders/</code>에 저장
  </Card>

  <Card title="HunyuanVideo 1.5 VAE 다운로드" icon="download" href="https://huggingface.co/Comfy-Org/HunyuanVideo_1.5_repackaged/blob/main/split_files/vae/hunyuanvideo15_vae_fp16.safetensors?download=true">
    hunyuanvideo15\_vae\_fp16.safetensors. <code>ComfyUI/models/vae/</code>에 저장
  </Card>
</CardGroup>

#### 저장 위치

```
ComfyUI/
├── 📂 models/
│   ├── 📂 text_encoders/
│   │   ├── qwen_2.5_vl_7b_fp8_scaled.safetensors
│   │   └── byt5_small_glyphxl_fp16.safetensors
│   └── 📂 vae/
│       └── hunyuanvideo15_vae_fp16.safetensors
```

## Hunyuan Video 1.5 텍스트 기반 비디오 생성 워크플로

HunyuanVideo 1.5 텍스트 기반 비디오 생성은 5\~10초 비디오를 생성하며, 품질을 높이면서 VRAM 요구량을 줄입니다.

![ComfyUI 워크플로 - Hunyuan Video 1.5 T2V](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_hunyuan_video_1.5_720p_t2v-1.webp)

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=video_hunyuan_video_1.5_720p_t2v&utm_source=docs&utm_medium=referral&utm_campaign=hunyuan-video-1-5">
    Comfy Cloud에서 열기
  </Card>

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

### 모델 다운로드

<CardGroup cols={2}>
  <Card title="T2V 디퓨전 모델 다운로드" icon="download" href="https://huggingface.co/Comfy-Org/HunyuanVideo_1.5_repackaged/blob/main/split_files/diffusion_models/hunyuanvideo1.5_720p_t2v_fp16.safetensors?download=true">
    hunyuanvideo1.5\_720p\_t2v\_fp16.safetensors. <code>ComfyUI/models/diffusion\_models/</code>에 저장
  </Card>
</CardGroup>

#### 모델 저장 위치

```
ComfyUI/
├── 📂 models/
│   ├── 📂 text_encoders/
│   │   ├── qwen_2.5_vl_7b_fp8_scaled.safetensors       // 공유 모델
│   │   └── byt5_small_glyphxl_fp16.safetensors           // 공유 모델
│   ├── 📂 vae/
│   │   └── hunyuanvideo15_vae_fp16.safetensors           // 공유 모델
│   └── 📂 diffusion_models/
│       └── hunyuanvideo1.5_720p_t2v_fp16.safetensors     // T2V 모델
```

### 워크플로 실행 단계

1. `DualCLIPLoader` 노드에 다음 모델이 로드되었는지 확인:
   * clip\_name1: `qwen_2.5_vl_7b_fp8_scaled.safetensors`
   * clip\_name2: `byt5_small_glyphxl_fp16.safetensors`
2. `Load Diffusion Model` 노드에 `hunyuanvideo1.5_720p_t2v_fp16.safetensors`가 로드되었는지 확인
3. `Load VAE` 노드에 `hunyuanvideo15_vae_fp16.safetensors`가 로드되었는지 확인
4. `Queue` 버튼을 클릭하거나 `Ctrl(Cmd) + Enter` 단축키로 워크플로 실행

<Tip>
  워크플로에는 초해상도 업스케일러 노드가 포함되어 있습니다. 활성화하면 `hunyuanvideo1.5_1080p_sr_distilled_fp16.safetensors`를 사용해 출력을 1080p로 업스케일합니다.
</Tip>

## Hunyuan Video 1.5 이미지-투-비디오 워크플로

HunyuanVideo 1.5 이미지-투-비디오는 정지 이미지를 부드럽고 고품질의 비디오로 변환하며, 일관성과 모션 역학을 개선합니다.

![ComfyUI 워크플로 - Hunyuan Video 1.5 I2V](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_hunyuan_video_1.5_720p_i2v-1.webp)

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=video_hunyuan_video_1.5_720p_i2v&utm_source=docs&utm_medium=referral&utm_campaign=hunyuan-video-1-5">
    Comfy Cloud에서 열기
  </Card>

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

**입력 소재**

<CardGroup cols={2}>
  <Card title="입력 이미지" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/video_hunyuan_video_1.5_720p_i2v_input_image.png">
    기본 입력 이미지를 다운로드하거나, 자신의 이미지를 시작 프레임으로 사용하세요.
  </Card>
</CardGroup>

### 모델 다운로드

<CardGroup cols={2}>
  <Card title="CLIP Vision 다운로드" icon="download" href="https://huggingface.co/Comfy-Org/sigclip_vision_384/blob/main/sigclip_vision_patch14_384.safetensors?download=true">
    sigclip\_vision\_patch14\_384.safetensors. <code>ComfyUI/models/clip\_vision/</code>에 저장
  </Card>

  <Card title="I2V 디퓨전 모델 다운로드" icon="download" href="https://huggingface.co/Comfy-Org/HunyuanVideo_1.5_repackaged/blob/main/split_files/diffusion_models/hunyuanvideo1.5_720p_i2v_fp16.safetensors?download=true">
    hunyuanvideo1.5\_720p\_i2v\_fp16.safetensors. <code>ComfyUI/models/diffusion\_models/</code>에 저장
  </Card>
</CardGroup>

#### 모델 저장 위치

```
ComfyUI/
├── 📂 models/
│   ├── 📂 clip_vision/
│   │   └── sigclip_vision_patch14_384.safetensors          // I2V 비전 인코더
│   ├── 📂 text_encoders/
│   │   ├── qwen_2.5_vl_7b_fp8_scaled.safetensors           // 공유 모델
│   │   └── byt5_small_glyphxl_fp16.safetensors             // 공유 모델
│   ├── 📂 vae/
│   │   └── hunyuanvideo15_vae_fp16.safetensors             // 공유 모델
│   └── 📂 diffusion_models/
│       └── hunyuanvideo1.5_720p_i2v_fp16.safetensors       // I2V 모델
```

### 워크플로 실행 단계

1. `DualCLIPLoader` 노드에 다음 모델이 로드되었는지 확인:
   * clip\_name1: `qwen_2.5_vl_7b_fp8_scaled.safetensors`
   * clip\_name2: `byt5_small_glyphxl_fp16.safetensors`
2. `CLIPVisionLoader` 노드에 `sigclip_vision_patch14_384.safetensors`가 로드되었는지 확인
3. `Load Diffusion Model` 노드에 `hunyuanvideo1.5_720p_i2v_fp16.safetensors`가 로드되었는지 확인
4. `Load VAE` 노드에 `hunyuanvideo15_vae_fp16.safetensors`가 로드되었는지 확인
5. `Queue` 버튼을 클릭하거나 `Ctrl(Cmd) + Enter` 단축키로 워크플로 실행

## 초해상도 업스케일러

두 워크플로 모두 720p 출력 비디오를 1080p로 업스케일할 수 있는 초해상도 노드를 포함합니다. 이 선택적 업스케일러는 증류 모델을 사용해 효율적인 고해상도 출력을 제공합니다.

<Card title="1080p 업스케일러 다운로드" icon="download" href="https://huggingface.co/Comfy-Org/HunyuanVideo_1.5_repackaged/blob/main/split_files/diffusion_models/hunyuanvideo1.5_1080p_sr_distilled_fp16.safetensors?download=true">
  hunyuanvideo1.5\_1080p\_sr\_distilled\_fp16.safetensors. <code>ComfyUI/models/diffusion\_models/</code>에 저장
</Card>

공유 모델과 워크플로별 모델 전체 목록:

```
ComfyUI/
├── 📂 models/
│   ├── 📂 clip_vision/
│   │   └── sigclip_vision_patch14_384.safetensors
│   ├── 📂 text_encoders/
│   │   ├── qwen_2.5_vl_7b_fp8_scaled.safetensors
│   │   └── byt5_small_glyphxl_fp16.safetensors
│   ├── 📂 vae/
│   │   └── hunyuanvideo15_vae_fp16.safetensors
│   └── 📂 diffusion_models/
│       ├── hunyuanvideo1.5_720p_t2v_fp16.safetensors        // T2V 모델
│       ├── hunyuanvideo1.5_720p_i2v_fp16.safetensors        // I2V 모델
│       └── hunyuanvideo1.5_1080p_sr_distilled_fp16.safetensors  // 업스케일러
```