Hunyuan 3D API 节点模型生成 ComfyUI 官方示例

本文将介绍如何在 ComfyUI 中使用 Hunyuan 3D 节点的 API 进行 3D 模型生成

Hunyuan 3D 3.0 是腾讯推出的最先进的 3D 生成模型，可在几分钟内完成 3D 内容创建。它可以通过文本提示、图像或草图生成可用于生产的 3D 资产，大大降低了传统 3D 建模流程的门槛。

ComfyUI 现已原生集成了相应的 Hunyuan 3D API，让您可以方便地在 ComfyUI 中使用相关节点进行模型生成。

目前，ComfyUI 的合作伙伴节点支持以下 Hunyuan 3D 模型生成功能：

• 文本到 3D 生成
• 图像到 3D 生成
• 多视图到 3D 生成

To use the API nodes, you need to ensure that you are logged in properly and using a permitted network environment. Please refer to the API Nodes Overview section of the documentation to understand the specific requirements for using the API nodes.

Portable or self deployed users

Make sure your ComfyUI is updated.

• Download ComfyUI
• Update Guide

Workflows in this guide can be found in the Workflow Templates. If you can’t find them in the template, your ComfyUI may be outdated. (Desktop version’s update will delay sometime)

If nodes are missing when loading a workflow, possible reasons:

1. You are not using the latest ComfyUI version (Nightly version)
2. Some nodes failed to import at startup

Desktop or Cloud users

• The Desktop is base on ComfyUI stable release, it will auto-update when there is a new Desktop stable release available.
• Cloud will update after ComfyUI stable release.

So, if you find any core node missing in this document, it might be because the new core nodes have not yet been released in the latest stable version. Please wait for the next stable release.

​

使用场景

• 游戏开发创意：快速生成角色、道具和环境，具有优化的拓扑结构，适用于绑定和实时渲染
• 产品与电商：将产品照片转换为交互式 3D 模型，用于在线展示
• 工业设计：草图到 3D 原型制作和 3D 打印就绪的零件分解
• 视觉特效与动画：具有专业 UV 和 PBR 材质的高分辨率资产

​

开始使用

​

1. 访问工作流模板

1. 打开侧边栏中的模板库
2. 导航到 3D → Hunyuan 3D
3. 选择 Hunyuan 3D 的工作流模板

​

2. 运行工作流

1. 根据工作流类型输入文本提示、图像或草图
2. 点击 Run 按钮，或使用快捷键 Ctrl(cmd) + Enter 执行模型生成
3. 工作流完成后，预览并导出您的 3D 模型

​

文本到 3D 工作流

输入文本描述即可一键生成 3D 模型。模型能够准确遵循风格、形状和材质细节，确保结果一致。

示例提示词：“带齿轮的机械海豚，蒸汽朋克风格”

Hunyuan 3D 文本到 3D 工作流

在 Comfy Cloud 上运行

​

图像到 3D 工作流

上传一张或多张图像以生成高质量的 3D 模型。支持 2-4 张多视图图像可提高几何和材质的保真度。

Hunyuan 3D 图像到 3D 工作流

在 Comfy Cloud 上运行

​

多视图到 3D 工作流

提供多个视角的图像（正面、背面、侧面）以生成精度和细节更高的 3D 模型。此功能与图像到 3D 使用相同的工作流——只需上传 2-4 张不同角度的图像即可。

Hunyuan 3D 图像到 3D 工作流

在 Comfy Cloud 上运行

​

高级功能

继 HY 3D 3.0 初始集成 之后，Hunyuan 3D 的高级处理功能现已通过合作伙伴节点提供。这些工作流通过将关键后处理步骤引入 ComfyUI，帮助弥合生成与生产之间的差距。

​

3D 零件分解

将完整的 3D 模型拆分为有意义的结构部件，如盔甲、配件、车轮或其他独立组件。这使得编辑资产的特定区域、交换部件以创建变体、以及为模块化工作流、动画或下游组装准备模型变得更加容易。

在 Comfy Cloud 上运行

运行工作流

下载工作流

获取 JSON 文件

​

UV 展开

自动为支持的 3D 模型生成 UV 布局，将原始几何体转换为更易于贴图的资产。无需手动切割接缝和组织 UV 岛，创作者可以更快地进入绑定、烘焙和材质工作，并拥有更清晰的起点。

在 Comfy Cloud 上运行

运行工作流

下载工作流

获取 JSON 文件

​

智能拓扑

将密集几何体转换为具有更有组织的边缘流的更干净的网格，帮助生成的模型更容易在实际生产流程中优化和重用。这在为游戏引擎、实时渲染或任何受益于低密度、结构更好的几何体的工作流准备资产时特别有用。

在 Comfy Cloud 上运行

运行工作流

下载工作流

获取 JSON 文件