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

# 混元视频 1.5 ComfyUI 教程

> 了解如何使用混元视频 1.5，一个轻量级的 8.3B 参数模型，可在消费级 GPU 上生成高质量视频

[HunyuanVideo 1.5](https://github.com/Tencent/HunyuanVideo) 是由腾讯混元团队开发的轻量级 8.3B 参数模型。它可在消费级 GPU（24GB 显存）上提供旗舰级质量的视频生成，大幅降低了使用门槛，同时不影响质量。

<Tip>
  <Tabs>
    <Tab title="本地用户">
      请确保你的 ComfyUI 已经更新。

      * [ComfyUI 下载](https://www.comfy.org/download)
      * [ComfyUI 更新教程](/zh/installation/update_comfyui)

      本指南里的工作流可以在[工作流模板](/zh/interface/features/template)中找到。如果找不到，可能是 ComfyUI 没有更新。

      如果加载工作流时有节点缺失，可能原因有：

      1. 你用的不是最新版（每夜版）。
      2. 启动时有些节点导入失败。
    </Tab>

    <Tab title="云端用户">
      * [Cloud](https://cloud.comfy.org) 会在 ComfyUI 稳定版本发布后更新。

      所以，如果你发现本文档中有任何核心节点缺失，可能是因为新核心节点尚未在最新稳定版中发布。请等待下一个稳定版发布。
    </Tab>
  </Tabs>
</Tip>

## 模型亮点

* **小巧强大**：在消费级硬件上运行的同时，提供与大型模型相当的 SOTA 性能。
* **多功能生成**：支持高质量的文本生成视频和图像生成视频（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
```

## 混元视频 1.5 文生视频工作流

混元视频 1.5 文生视频可根据自然语言描述生成 5-10 秒视频，质量更高且显存需求更低。

![ComfyUI 工作流 - 混元视频 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>

## 混元视频 1.5 图生视频工作流

混元视频 1.5 图生视频可将静态图像转换为流畅、高质量的视频，一致性和运动动态均有提升。

![ComfyUI 工作流 - 混元视频 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  // 放大模型
```