Skip to content
帮助构建更好的 ComfyUI 知识库 成为赞助者
系列教程ComfyUI 进阶教程3dHunyuan3D 2.0
新闻|

字节跳动发布 InfiniteYou：保留用户身份特征的灵活图像再创作框架

2025/03/21

Hunyuan3D 2.0 完整使用指南，包括 ComfyUI 原生支持、ComfyUI-Hunyuan3DWrapper

Hunyuan 3D 2 Hunyuan 3D 2

Hunyuan3D-2 是腾讯推出的开源 3D 生成大模型系列，目前（2025 年 3 月）最新版本为 2.0, 支持通过文本、图像或草图生成带有高分辨率纹理贴图的高保真 3D 模型。

技术亮点

系统采用 几何生成 + 纹理合成 的分离式流程：

  • 几何生成（Hunyuan3D-DiT）：基于流扩散模型生成无纹理的 3D 几何模型，参数量达 2.6B，可精准提取输入图像或文本的几何信息。
  • 纹理合成（Hunyuan3D-Paint）：为几何模型添加高分辨率（4K）纹理，参数量 1.3B，支持多视图扩散生成技术，确保纹理逼真且光照一致。

通过解耦形状与纹理生成，有效降低了复杂度并提升生成质量。

性能与效率优化

  • 快速生成：最快 30 秒完成模型生成，加速版本（Hunyuan3D-DiT-v2-0-Fast）通过指导蒸馏技术将推理时间缩短 50%。
  • 多模态输入：支持文本描述、图片、草图等多种输入方式，兼容 Blender 插件和 Gradio 应用，降低使用门槛。

开源模型生态 项目开源了 6 个模型（部分为简化版），覆盖不同场景需求：

  • Hunyuan3D-2mv：多视角形状生成模型，适用于复杂场景建模。
  • Hunyuan3D-Delight-v2-0：图像去光影模型，生成光照不变的纹理。 其他模型包括轻量级版本（2mini）、高保真几何生成（DiT-v2-0）等。

下面一些在线体验或者不依赖 ComfyUI 的实现来体验 Hunyuan3D 2.0 的方式：

下面我们将开始介绍在 ComfyUI 中实现 Hunyuan3D 2.0 模型生成的方案。

实现 Hunyuan3D 2.0 模型生成的 ComfyUI 方案

下面是在本篇指南中将会主要涉及的内容，我会提供对应完整的工作流和相关步骤教程。

ComfyUI-Hunyuan3DWrapper

由 Kijai 开发，目前在ComfyUI 中表现和支持的效果比较完整，能实现从模型到材质的整体渲染输出，但是材质生成部分需要单独编译一个相关的组件，需要稍微懂一些 Python 虚拟环境及 pip 相关的简单知识

ComfyUI-Hunyuan3DWrapper example

ComfyUI 官方原生支持

ComfyUI-Hunyuan3DWrapper example

目前 ComfyUI 已经官方支持了 Hunyuan3D 2.0 及 2mv 系列的模型，可以渲染出模型，但是目前还没有支持材质渲染，最后输出的是体素模型,不过也挺有美感的，只需要更新到 ComfyUI 最新版本即可使用, 使用和体验都比较简单

ComfyUI 3D Pack

这个插件主要还是它的依赖环境和最新的 ComfyUI 依赖环境不同，导致安装非常困难，我尝试了很多次也没有成功安装，所以这里在本文里我只能给出本文的相关部分给出介绍以及相关的资源。

输入图片

由于在本示例中涉及了多个工作流，所以在这里我们提供了对应的输入输入图片，这些素材都来自于 comfyUI 官方文档 中使用的示例图片，你也可以使用自己的图片来生成。

由于 ComfyUI-Hunyuan3DWrapper 插件使用了 ComfyUI-essentials 插件节点来完成了背景的自动移除，而 ComfyUI 原生支持的工作流并没有提供相应的功能，目前这里提供的图片都是处理后的，如果你需要使用自己的图片，可以参考 ComfyUI-Hunyuan3DWrapper 插件的背景移除部分来实现背景的自动移除。

input imageinput imageinput image
input imageinput imageinput image

ComfyUI-Hunyuan3DWrapper Hunyuan3D 2.0 工作流

这部分，我们将使用 ComfyUI-Hunyuan3DWrapper 插件来实现 Hunyuan3D 2.0 模型生成，我重新整理了对应的工作流，并添加了模型下载链接到工作流文件中。

1. 相关插件安装

Kijai 的工作流依赖于下面两个插件：

你可以通过 ComfyUI Manager 来安装上面的插件

1.1 插件基础依赖安装

这部分熟悉 ComfyUI 插件安装的读者应该比较熟悉，如果你是通过 ComfyUI Manager 安装的插件，那么插件应该会自动完成安装。

如果你是通过手动或者 git 安装，你需要在对应的 ComfyUI 的虚拟环境中执行依赖安装的命令，

对应插件依赖安装请参考 ComfyUI插件的安装指南 最后的依赖安装部分来完成。

1.2 纹理生成相关组件安装

在安装完成 ComfyUI-Hunyuan3DWrapper 基础依赖后，纹理生成部分依赖的组件需要编译安装。作者已经提供了针对特定环境的预编译wheel文件。

对应的文件，作者在对应的目录下已经提供了，并且在插件的 Readme 中也有说明如何使用，考虑到 ComfyUI Wiki 的读者是多语言用户，所以在这里对这部分的内容进行了一定的翻译整理 Hunyuan3Dwrapper-dependencies

1.2.1 预编译wheel文件安装

以下是针对不同环境的预编译wheel文件安装，如果没有符合你环境的版本，请参考自行编译安装部分

针对Windows 11 Python 3.12 CUDA 12.6环境：

pip install wheels\custom_rasterizer-0.1-cp312-cp312-win_amd64.whl
1.2.2 自行编译安装（如预编译文件不适用于你的系统）

如果预编译的wheel文件不适用于你的系统，你需要自行编译：

编译并安装Rasterizer：

cd hy3dgen/texgen/custom_rasterizer
python setup.py install

或者使用以下命令构建wheel文件，然后安装：

python setup.py bdist_wheel

这会在dist子文件夹中创建.whl文件，然后使用pip安装到你的Python环境中。

安装成功后，应在Python环境的site-packages文件夹中看到custom_rasterizer_kernel*.pyd文件和custom_rasterizer文件夹。

编译mesh_processor扩展：

cd hy3dgen/texgen/differentiable_renderer
python setup.py build_ext --inplace

这个文件应该存在于该文件夹中。它仅用于顶点修复，如果此文件不存在，将在CPU上运行备用方案，速度会慢很多。顶点修复在单独的节点上，最坏情况下可以绕过，缺点是纹理填充效果较差。

1.3 可选安装: BPT（边界保护变换）

该组件是完全可选的，但安装要求较高：

cd ComfyUI-Hunyuan3DWrapper\hy3dgen\shapegen\bpt
pip install -r requirements.txt

下载权重文件：bpt-8-16-500m.pt

将bpt-8-16-500m.pt复制到ComfyUI-Hunyuan3DWrapper-main\hy3dgen\shapegen\bpt目录。

1.4 修复高多边形模型UV包装的Xatlas升级程序

要修复高多边形模型的UV贴图问题，可以升级Xatlas：

首先卸载当前版本：

python_embeded\python.exe -m pip uninstall xatlas

在便携版根目录（ComfyUI_windows_portable）下：

git clone --recursive https://github.com/mworchel/xatlas-python.git
cd .\xatlas-python\extern

删除xatlas文件夹，然后克隆新版本：

git clone --recursive https://github.com/jpcy/xatlas

在xatlas-python\extern\xatlas\source\xatlas中修改xatlas.cpp文件：

  • 将第6774行的#if 0改为//#if 0
  • 将第6778行的#endif改为//#endif

最后返回便携版根目录（ComfyUI_windows_portable）执行：

.\python_embeded\python.exe -m pip install .\xatlas-python\

2. Hunyuan3D 2.0 单视角工作流

Hunyuan3D 2.0 的模型不是一个多视角模型，因此在使用 ComfyUI-Hunyuan3DWrapper 时，需要使用 Hunyuan3D-DiT-v2-0 系列模型而非 Hunyuan3D-DiT-v2-mv 系列。该插件不仅支持模型几何形状生成，还支持纹理生成，可以生成完整的 3D 模型。

2.1 工作流文件

下载下面的工作流文件，并拖入 ComfyUI ，将会自动提示完成相关模型的下载。

2.2 手动模型安装

由于早期 Hunyuan3D 2.0 发布时并没有提供 safetensors 格式的模型，所以 Kijai 提供了对应的转换后的版本，但目前 Hunyuan3D 2.0 已经提供了 safetensors 格式的模型，你可以从下面任选一个模型进行下载，并保存到 ComfyUI/models/diffusion_models/ 目录下。

2.3 按图片完成工作流的运行

Hunyuan3DWrapper_singleview_1 Hunyuan3DWrapper_singleview_2

  1. 请在 Hy3DModelLoader处确保对应的hunyuan3d-dit-v2-0.safetensors 已经加载
  2. 请在 Load Image 节点处加载对应的输入图片，用于模型生成
  3. 点击 Queue 按钮，或者使用快捷键 Ctrl(cmd) + Enter(回车) 来运行工作流
💡

如果有出现关于 custom_rasterizer 的报错，请参考插件安装部分提供的解决方便进行对应的依赖组件的安装或者编译 对应模型将会输出至 ComfyUI/output/3D 文件夹中,这个是在Hy3DExportMesh节点中设置的输出路径

3. Hunyuan3D 2.0 多视角工作流

3.1 工作流文件

下载下面的工作流文件，并拖入 ComfyUI ，将会自动提示完成相关模型的下载。

3.2 手动模型安装

Hunyuan3D 2mv 多视角模型与之前相同，Kijai 也提供了早期转换过的版本，后续tencent 也提供了对应的 safetensors 版本，你可以从下面任选一个模型进行下载，并保存到 ComfyUI/models/diffusion_models/ 目录下。

💡

如果生成运行太过缓慢，你可以尝试使用:

3.3 按图片完成工作流的运行

Hunyuan3DWrapper_multiview_1 Hunyuan3DWrapper_multiview_2

  1. 请在 Hy3DModelLoader处确保对应的hunyuan3d-dit-v2-mv-fp16.safetensors 已经加载
  2. 请在 Load Image 节点出上传不同视角的输入图片，如果对应视角的图片没有，请在右键将对应的节点 mode 设置为 Never
  3. 点击 Run 按钮，或者使用快捷键 Ctrl(cmd) + Enter(回车) 来运行工作流

ComfyUI 原生 Hunyuan3D 2.0 工作流

目前 ComfyUI 已经原生支持 Hunyuan3D-2mv 系列模型，可以直接生成 3D 几何模型（暂不支持纹理材质），只需要升级 ComfyUI 到最新版本即可体验。 由于 ComfyUI Wiki 已经开始和 Comfy 官方一起协作维护Comfy 官方文档，这部分内容在 Comfy 官方文档 中我们已有详细介绍。 但目前官方文档我们仅对中英文进行了支持，为了方便 ComfyUI Wiki 的读者，ComfyUI Wiki 对原本发布在 docs.comfy.org 在我们的站点进行了重新的整理和编辑。

目前 ComfyUI 提供三个原生的工作流，主要是对 Hunyuan3D 2.0 和 Hunyuan3D-2mv 系列模型的支持。

  • Hunyuan3D-2mv 多视角工作流
  • Hunyuan3D-2mv-turbo 多视角加速版工作流
  • Hunyuan3D-2 单视角工作流

目前这个工作流已经在最新版本的 ComfyUI 工作流模板中新增了，你可以看到在菜单栏 workflow -> workflow templates -> 3d 中看到对应的 Hunyuan3D 2.0 工作流

ComfyUI 原生工作流模板

💡

请在开始这部分内容之前，确保你已经升级到了最新版本的 ComfyUI,你可以参考ComfyUI 升级指南 进行 ComfyUI 的更新。

  • 与 ComfyUI-Hunyuan3DWrapper 对比，原生工作流把对应模型位置保存在ComfyUI/models/checkpoints/ 目录下，使用的模型是相同的的，所以如果你之前使用的是 ComfyUI-Hunyuan3DWrapper 插件工作流，注意调整下对应模型保存的目录。
  • 对应.glb 文件的输出位置在 ComfyUI/output/mesh 目录下,这个是在SaveGLB节点中设置的输出路径。

1. 使用 Hunyuan3D-2mv 多视角工作流

1.1 工作流示例

下载下面的图片，并拖入 ComfyUI 中，将会自动提示完成相关模型的下载。

Hunyuan3D-2mv 工作流

1.2 手动模型安装

下载 hunyuan3d-dit-v2-mv.safetensors 并保存到 ComfyUI/models/checkpoints/ 目录, 并重命名为 hunyuan3d-dit-v2-mv.safetensors。

1.3 按步骤完成工作流的运行

Hunyuan3D-2mv 工作流

  1. 确保 Image Only Checkpoint Loader(img2vid model) 节点加载了 hunyuan3d-dit-v2-mv.safetensors 模型
  2. 在各个 Load Image 节点中加载对应视角的图片
  3. 运行工作流生成 3D 模型

2. 使用 Hunyuan3D-2mv-turbo 加速版工作流

Hunyuan3D-2mv-turbo 是 Hunyuan3D-2mv 的蒸馏版本，运行速度更快。

2.1 工作流示例

下载下面的图片，并拖入 ComfyUI 中，将会自动提示完成相关模型的下载。

Hunyuan3D-2mv-turbo 工作流

2.2 手动模型安装

下载 hunyuan3d-dit-v2-mv-turbo.safetensors 重命名为 hunyuan3d-dit-v2-mv-turbo.safetensors并保存到 ComfyUI/models/checkpoints/ 目录下。

2.3 按步骤完成工作流的运行

Hunyuan3D-2mv-turbo 工作流

  1. 确保 Image Only Checkpoint Loader(img2vid model) 节点加载了 hunyuan3d-dit-v2-mv-turbo.safetensors 模型
  2. 在各个 Load Image 节点中加载对应视角的图片
  3. 在此工作流中，注意 cfg 设置为 1.0，并增加了 flux guidance 节点来控制蒸馏 cfg 的生成
  4. 运行工作流生成 3D 模型

3. 使用 Hunyuan3D-2 单视角工作流

Hunyuan3D-2 模型支持单视角输入生成 3D 模型。

3.1 工作流示例

下载下面的图片，并拖入 ComfyUI 中，将会自动提示完成相关模型的下载。

Hunyuan3D-2 工作流

3.2 输入图像示例

输入图像

3.3 手动安装模型

下载 hunyuan3d-dit-v2.safetensors 重命名为hunyuan3d-dit-v2.safetensors 并保存到 ComfyUI/models/checkpoints/ 目录，

3.4 按步骤完成工作流的运行

ComfyUI Native

  1. 确保 Image Only Checkpoint Loader(img2vid model) 节点加载了 hunyuan3d-dit-v2.safetensors 模型
  2. 在 Load Image 节点中加载输入图片
  3. 注意此工作流使用 Hunyuan3Dv2Conditioning 节点而非Hunyuan3Dv2ConditioningMultiView
  4. 运行工作流生成 3D 模型

ComfyUI 3D Pack

在安装 ComfyUI 3D Pack 时可能遇到的主要问题是依赖关系冲突。该插件依赖的环境与最新版本的 ComfyUI 环境有所不同，特别是在 PyTorch 版本和 CUDA 版本支持方面。如果你想尝试，可以参考 ComfyUI-3D-Pack 项目的安装说明。 另外有社区用户提供了对应的整合包的形式，你可以尝试Comfy3D-WinPortable | 整合包来体验

其它补充内容

如何进行文生模型

在上面的工作流中，我们使用的都是输入图片的形式，你可以在这个工作流之前加上一个文生图的工作流，来完成对应图片部分的内容生成，如果需要多视角的输入，你可以尝试使用ComfyUI-MVAdapter 插件的功能来完成对应角色的多角度图片生成。

混元3D 2.0 开源模型系列

目前混元3D 2.0 开源了多个模型，覆盖了完整的3D生成流程，你可以访问 Hunyuan3D-2 了解更多。

Hunyuan3D-2mini 系列

模型描述日期参数Huggingface
Hunyuan3D-DiT-v2-miniMini 图像到形状模型2025-03-180.6B前往

Hunyuan3D-2mv 系列

模型描述日期参数Huggingface
Hunyuan3D-DiT-v2-mv-Fast指导蒸馏版本，可以将 DIT 推理时间减半2025-03-181.1B前往
Hunyuan3D-DiT-v2-mv多视角图像到形状模型，适合需要用多个角度理解场景的 3D 创作2025-03-181.1B前往

Hunyuan3D-2 系列

模型描述日期参数Huggingface
Hunyuan3D-DiT-v2-0-Fast指导蒸馏模型2025-02-031.1B前往
Hunyuan3D-DiT-v2-0图像到形状模型2025-01-211.1B前往
Hunyuan3D-Paint-v2-0纹理生成模型2025-01-211.3B前往
Hunyuan3D-Delight-v2-0图像去光影模型2025-01-211.3B前往

Hunyuan 3D 2.0 相关链接