> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 生成

<Tip>
  使用 API 节点需要保证你已经正常登录，并在受许可的网络环境下使用，请参考[API 节点总览](/zh/tutorials/partner-nodes/overview)部分文档来了解使用 API 节点的具体使用要求。
</Tip>

<Tip>
  <Tabs>
    <Tab title="便携版或手动安装用户">
      请确保你的 ComfyUI 已经更新。

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

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

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

      1. 你用的不是最新开发版（nightly）。
      2. 你用的是稳定版或桌面版（没有包含最新的更新）。
      3. 启动时有些节点导入失败。
    </Tab>

    <Tab title="桌面版或云端用户">
      * 桌面版是基于 ComfyUI 稳定版本构建的，它会在有新的桌面稳定版本发布时自动更新。
      * [Cloud](https://cloud.comfy.org) 会在 ComfyUI 稳定版本发布后更新，我们会同步更新 Cloud。

      所以，如果你发现本教程中有任何核心节点缺失，那是因为对应的节点支持还在开发中没有发布正式的稳定版，请等待下一个稳定版本发布。
    </Tab>
  </Tabs>
</Tip>

## 使用场景

* **游戏开发创意**：快速生成角色、道具和环境，具有优化的拓扑结构，适用于绑定和实时渲染
* **产品与电商**：将产品照片转换为交互式 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 模型。模型能够准确遵循风格、形状和材质细节，确保结果一致。

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

<Card title="Hunyuan 3D 文本到 3D 工作流" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_text_to_model&utm_source=docs&utm_medium=inhouse_social&utm_campaign=inhouse_feature_launches&utm_content=post&utm_niche=workflow_engineering&utm_creator=purz">
  在 Comfy Cloud 上运行
</Card>

## 图像到 3D 工作流

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

<Card title="Hunyuan 3D 图像到 3D 工作流" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_image_to_model&utm_source=docs&utm_medium=inhouse_social&utm_campaign=inhouse_feature_launches&utm_content=post&utm_niche=workflow_engineering&utm_creator=purz">
  在 Comfy Cloud 上运行
</Card>

## 多视图到 3D 工作流

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

<Card title="Hunyuan 3D 图像到 3D 工作流" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_image_to_model&utm_source=docs&utm_medium=inhouse_social&utm_campaign=inhouse_feature_launches&utm_content=post&utm_niche=workflow_engineering&utm_creator=purz">
  在 Comfy Cloud 上运行
</Card>

## 高级功能

继 [HY 3D 3.0 初始集成](https://blog.comfy.org/p/hunyuan-3d-30-in-comfyui-state-of) 之后，Hunyuan 3D 的高级处理功能现已通过合作伙伴节点提供。这些工作流通过将关键后处理步骤引入 ComfyUI，帮助弥合生成与生产之间的差距。

### 3D 零件分解

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

<Card title="在 Comfy Cloud 上运行" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_part&utm_source=docs">
  运行工作流
</Card>

<Card title="下载工作流" icon="github" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_hunyuan3d_part.json">
  获取 JSON 文件
</Card>

### UV 展开

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

<Card title="在 Comfy Cloud 上运行" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_model2uv&utm_source=docs">
  运行工作流
</Card>

<Card title="下载工作流" icon="github" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_hunyuan3d_model2uv.json">
  获取 JSON 文件
</Card>

### 智能拓扑

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

<Card title="在 Comfy Cloud 上运行" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_smart_topology&utm_source=docs">
  运行工作流
</Card>

<Card title="下载工作流" icon="github" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_hunyuan3d_smart_topology.json">
  获取 JSON 文件
</Card>