Hunyuan3D 2.0 与 2.1：ComfyUI 图像转 3D 网格工作流

在 ComfyUI 中使用腾讯开源的 Hunyuan3D 2.0、2.1 和 turbo 模型，从单张图像或四视角图像生成 3D 网格。

混元3D 2.0 简介

混元3D 2.0 是腾讯推出的开源 3D 资产生成模型，可以通过文本或图像生成带有高分辨率纹理贴图的高保真 3D 模型。

混元3D 2.0 采用两阶段生成方式，首先生成无纹理的几何模型，再合成高分辨率纹理贴图。这有效分离了形状和纹理生成的复杂性。下面是混元3D 2.0 的两个核心组件：

1. 几何生成模型（Hunyuan3D-DiT）：基于流扩散 Transformer 架构，生成无纹理的几何模型，可精准匹配输入条件。
2. 纹理生成模型（Hunyuan3D-Paint）：结合几何条件和多视图扩散技术，为模型添加高分辨率纹理，支持 PBR 材质。

主要优势

• 高精度生成：几何结构锐利，纹理色彩丰富，支持 PBR 材质生成，实现接近真实的光影效果。
• 多样化使用方式：提供代码调用、Blender 插件、Gradio 应用及官网在线体验，适合不同用户需求。
• 轻量化与兼容性：Hunyuan3D-2mini 模型仅需 5GB 显存，标准版本形状生成需 6GB 显存，完整流程（形状+纹理）仅需 12GB 显存。

近期（2025 年 3 月 18 日），混元3D 2.0 还引入了多视角形状生成模型（Hunyuan3D-2mv），支持从不同角度输入生成更精细的几何结构。

本示例包含四个工作流：

• 使用 Hunyuan3D-2mv 配合多个视图输入生成 3D 模型
• 使用 Hunyuan3D-2mv-turbo 配合多个视图输入生成 3D 模型
• 使用 Hunyuan3D-2 配合单个视图输入生成 3D 模型
• 使用 Hunyuan3D 2.1 配合单个视图输入生成 3D 模型

[!TIP] 目前 ComfyUI 已原生支持 Hunyuan3D-2mv，但暂未支持纹理和材质的生成。请在开始之前确保你已更新到最新版本的 ComfyUI。 本教程中的工作流示例 PNG 图像在其元数据中包含工作流 JSON： 您可以将它们直接拖入 ComfyUI 或者使用菜单 Workflows -> Open (ctrl+o) 这样可以加载对应的工作流并提示您下载所需的模型。生成的 .glb 格式模型将输出至 ComfyUI/output/mesh 文件夹。

ComfyUI Hunyuan3D-2mv 工作流示例

在 Hunyuan3D-2mv 工作流中，我们将使用多视角的图片来生成 3D 模型。注意，多个视角的图片在此工作流中并非必需。你只需使用 front 视角的图片即可生成 3D 模型。

[!TIP] > [tab] 本地用户 > > 请确保你的 ComfyUI 已经更新。 > > ComfyUI 下载 > ComfyUI 更新教程 > > 本指南里的工作流可以在工作流模板中找到。如果找不到，可能是 ComfyUI 没有更新。 > > 如果加载工作流时有节点缺失，可能原因有： > > 1. 你用的不是最新版（每夜版）。 > 2. 启动时有些节点导入失败。 > [tab] 云端用户 > > * Cloud 会在 ComfyUI 稳定版本发布后更新。 > > 所以，如果你发现本文档中有任何核心节点缺失，可能是因为新核心节点尚未在最新稳定版中发布。请等待下一个稳定版发布。

HY 3D 2.0 MV

使用 Hunyuan3D 2.0 MV 从多个视角生成 3D 模型。

[card] 在 Comfy Cloud 上运行 立即在 Comfy Cloud 上运行此工作流

[card] 下载工作流 下载 JSON 或在模板库中搜索“HY 3D 2.0 MV”

输入材料

将这些文件上传到对应的 LoadImage 节点：

[card] 3d\_hunyuan3d\_multiview\_to\_model\_front\_image.png LoadImage 节点 56 · 前视图

[card] 3d\_hunyuan3d\_multiview\_to\_model\_left\_image.png LoadImage 节点 78 · 左视图

[card] 3d\_hunyuan3d\_multiview\_to\_model\_back\_image.png LoadImage 节点 80 · 后视图

[card] 3d\_hunyuan3d\_multiview\_to\_model\_right\_image.png LoadImage 节点 87 · 右视图

1. 工作流

请下载下面的图片，并拖入 ComfyUI 以加载工作流。

下载下面的图片，我们将把它们用作输入图像。

[!TIP] 在本示例中，输入图像已经过预处理，去除了多余的背景。在实际使用中，你可以使用类似 ComfyUI\_essentials 的自定义节点来自动去除多余背景。

2. 手动安装模型

下载下面的模型，并保存到对应的 ComfyUI 文件夹。

• hunyuan3d-dit-v2-mv：model.fp16.safetensors 下载后可重命名为 hunyuan3d-dit-v2-mv.safetensors

ComfyUI/
├── models/
│   ├── checkpoints/
│   │   └── hunyuan3d-dit-v2-mv.safetensors  // 重命名后的文件

3. 按步骤运行工作流

1. 确保 Image Only Checkpoint Loader (img2vid model) 加载了我们下载并重命名的 hunyuan3d-dit-v2-mv.safetensors 模型
2. 在每个 Load Image 节点中加载对应视角的图片
3. 点击 Queue 按钮，或使用快捷键 Ctrl(cmd) + Enter(回车) 运行工作流

如果你需要增加更多视角，请确保在 Hunyuan3Dv2ConditioningMultiView 节点中加载其它视角的图片，并确保在 Load Image 节点中加载了对应视角的图片。

Hunyuan3D-2mv-turbo 工作流

在 Hunyuan3D-2mv-turbo 工作流中，我们将使用 Hunyuan3D-2mv-turbo 模型来生成 3D 模型。该模型是 Hunyuan3D-2mv 的分步蒸馏版本，可以更快地生成 3D 模型。在此版本的工作流中，我们将 cfg 设置为 1.0，并添加一个 flux guidance 节点来控制 distilled cfg 的生成。

HY 3D 2.0 MV Turbo

使用 Hunyuan3D 2.0 MV Turbo 从多视角生成 3D 模型。

[card] 在 Comfy Cloud 上运行 在 Comfy Cloud 上立即运行此工作流

[card] 下载工作流 下载 JSON 或在模板库中搜索 "HY 3D 2.0 MV Turbo"

输入材料

将以下文件上传到对应的 LoadImage 节点：

[card] 3d\_hunyuan3d\_multiview\_to\_model\_turbo\_front\_view.png LoadImage 节点 56 · 前视图

[card] 3d\_hunyuan3d\_multiview\_to\_model\_turbo\_back\_view.png LoadImage 节点 82 · 后视图

[card] 3d\_hunyuan3d\_multiview\_to\_model\_turbo\_left\_view.png LoadImage 节点 85 · 左视图

[card] 3d\_hunyuan3d\_multiview\_to\_model\_turbo\_right\_view.png LoadImage 节点 87 · 右视图

1. 工作流

请下载下面的图片，并拖入 ComfyUI 以加载工作流。

下载下面的图像，我们将它们用作输入图像。

2. 手动安装模型

下载下面的模型，并保存到对应的 ComfyUI 文件夹。

• hunyuan3d-dit-v2-mv-turbo：model.fp16.safetensors。下载后，可将其重命名为 hunyuan3d-dit-v2-mv-turbo.safetensors

ComfyUI/
├── models/
│   ├── checkpoints/
│   │   └── hunyuan3d-dit-v2-mv-turbo.safetensors  // renamed file

3. 按步骤运行工作流

1. 确保 Image Only Checkpoint Loader(img2vid model) 节点已加载我们重命名后的 hunyuan3d-dit-v2-mv-turbo.safetensors 模型。
2. 在每个 Load Image 节点中加载对应的视角图像。
3. 点击 Queue 按钮，或使用快捷键 Ctrl(cmd) + Enter 来运行工作流。

Hunyuan3D-2 单视图工作流

在 Hunyuan3D-2 工作流中，我们将使用 Hunyuan3D-2 模型来生成 3D 模型。这个模型不是多视角模型。在这个工作流中，我们使用 Hunyuan3Dv2Conditioning 节点，而不是 Hunyuan3Dv2ConditioningMultiView 节点。

HY 3D 2.0

使用 Hunyuan3D 2.0 从单张图像生成 3D 模型。

[card] 在 Comfy Cloud 上运行 立即在 Comfy Cloud 上运行此工作流

[card] 下载工作流 下载 JSON 或在模板库中搜索 "HY 3D 2.0"

输入素材

将该文件上传到对应的 LoadImage 节点：

[card] 3d\_hunyuan3d\_image\_to\_model\_input\_image.png LoadImage 节点 56 · 3d_hunyuan3d_image_to_model_input_image.png

1. 工作流

请下载下方图片并将其拖入 ComfyUI 以加载工作流。

下载下方图片，我们将用它作为输入图像。

2. 手动安装模型

下载下方模型并将其保存到对应的 ComfyUI 文件夹：

• hunyuan3d-dit-v2-0: model.fp16.safetensors — 下载后可将其重命名为 hunyuan3d-dit-v2.safetensors

ComfyUI/
├── models/
│   ├── checkpoints/
│   │   └── hunyuan3d-dit-v2.safetensors  // 重命名后的文件

3. 按步骤运行工作流

1. 确保 Image Only Checkpoint Loader(img2vid model) 节点已加载我们重命名后的 hunyuan3d-dit-v2.safetensors 模型
2. 在 Load Image 节点中加载图像
3. 点击 Queue 按钮，或使用快捷键 Ctrl(cmd) + Enter 运行工作流

Hunyuan3D 2.1 单视图工作流

Hunyuan3D 2.1 是腾讯于 2025 年 6 月发布的 3D 形状生成模型，在 Hunyuan3D 2.0 的基础上提升了几何细节与边缘锐度。ComfyUI 重打包的 checkpoint 将形状生成流程整合进单个文件，因此这个工作流只需下载一个模型，不必分别下载 DiT 与 VAE。与本页其他工作流一样，它输出的是无纹理的网格模型。

HY 3D 2.1

使用 Hunyuan3D 2.1 从单张图像生成 3D 网格模型。

[card] 在 Comfy Cloud 上运行 立即在 Comfy Cloud 上运行此工作流

[card] 下载工作流 下载 JSON 或在模板库中搜索 "HY 3D 2.1"

输入素材

将该文件上传到对应的 LoadImage 节点：

[card] 3d\_hunyuan3d-v2.1\_input\_image.png LoadImage 节点 2 · 3d_hunyuan3d-v2.1_input_image.png

1. 手动安装模型

下载下方 checkpoint 并保存到 checkpoints 文件夹：

[card] hunyuan\_3d\_v2.1.safetensors 放到 ComfyUI/models/checkpoints/

📂 ComfyUI/
├── 📂 models/
│   └── 📂 checkpoints/
│       └── hunyuan_3d_v2.1.safetensors

该文件约 7.4 GB。

2. 按步骤运行工作流

1. 确保 Image Only Checkpoint Loader(img2vid model) 节点已加载 hunyuan_3d_v2.1.safetensors
2. 在 Load Image 节点中加载你的参考图像
3. 点击 Queue 按钮，或使用快捷键 Ctrl(cmd) + Enter 运行工作流

生成的 .glb 网格模型会保存到 ComfyUI/output/mesh/。

社区资源

下面是 Hunyuan3D-2 的相关的 ComfyUI 社区资源

• ComfyUI-Hunyuan3DWrapper
• Kijai/Hunyuan3D-2\_safetensors
• ComfyUI-3D-Pack

混元3D 2.0 开源模型系列

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

Hunyuan3D-2mini 系列

Hunyuan3D-2mv 系列

Hunyuan3D-2 系列