Hunyuan3D-Part：组件式 3D 生成模型

一、教程简介

Hunyuan3D-Part 是由腾讯混元团队于 2025 年 9 月推出的 3D 生成模型，由 P3–SAM 和 X–Part 组成，首次实现高精度、可控的组件式 3D 生成，支持 50 + 组件自动生成。用户可先用混元 3D 2.5 或 3.0 生成整体 Mesh，再由 P3–SAM 进行自动、精确的组件分割，X–Part 将其分解为独立部件，输出高保真、结构一致的部件几何体，同时保持灵活可控性。在游戏建模、 3D 打印等领域有广泛应用，如将汽车模型拆分车身和轮子，便于游戏绑定滚动逻辑或 3D 打印分步制作。相关论文成果为「P3-SAM: Native 3D Part Segmentation」和「X-Part: high fidelity and structure coherent shape decomposition」。

该教程算力资源采用单卡 RTX A6000 。

二、效果展示

P3-SAM：Native 3D part Segmentation

X-Part：high-fidelity and structure-coherent shape decomposition

三、运行步骤

1. 启动容器

2. 使用步骤

若显示「Bad Gateway」，这表示模型正在初始化，由于模型较大，请等待约 2-3 分钟后刷新页面。

注意：浏览器加载并显示 glb 文件需要 1 分钟左右，请耐心等待。

具体参数：

• Post-processing：是否启用 P3-SAM 内部的后处理步骤。
• Post-processing Threshold：当启用后处理时生效。这个阈值控制合并的强度。数值越小（如 0.8），表示允许合并的部件相似度要求越低，会导致更多的小部件被合并到相邻的大部件中，最终保留的部件数量越少。数值越大（如 0.99），则要求部件非常相似才会合并，保留的部件数量会更多。
• Random Seed：控制 P3-SAM 分割过程中涉及的随机性（例如采样点、颜色分配等）。

四、交流探讨

🖌️ 如果大家看到优质项目，欢迎后台留言推荐！另外，我们还建立了教程交流群，欢迎小伙伴们扫码备注【SD 教程】入群探讨各类技术问题、分享应用效果↓

引用信息

本项目引用信息如下：

@article{ma2025p3sam,
  title={P3-sam: Native 3d part segmentation},
  author={Ma, Changfeng and Li, Yang and Yan, Xinhao and Xu, Jiachen and Yang, Yunhan and Wang, Chunshi and Zhao, Zibo and Guo, Yanwen and Chen, Zhuo and Guo, Chunchao},
  journal={arXiv preprint arXiv:2509.06784},
  year={2025}
}

@article{yan2025xpart,
  title={X-Part: high fidelity and structure coherent shape decomposition},
  author={Yan, Xinhao and Xu, Jiachen and Li, Yang and Ma, Changfeng and Yang, Yunhan and Wang, Chunshi and Zhao, Zibo and Lai, Zeqiang and Zhao, Yunfei and Chen, Zhuo and others},
  journal={arXiv preprint arXiv:2509.08643},
  year={2025}
}