开源项目解析
混元 3D 2.1
腾讯混元的 3D 生成:图生 3D 与文生 3D,2.1 这一支带 PBR 材质生成。
中文侧主力带 PBR 材质许可证排除三地
许可证附加条件:2026-08-17 核许可证原文:授权区域不含欧盟、英国、韩国;且若你名下所有产品的月活合计超过一百万,必须另行向腾讯申请授权,未获批准前不得行使本协议下的权利。
读懂层
2 张 · 架构图 / 时序图
DeepWiki · 抓取 2026-08-17 · 核验 2026-08-17
DeepWiki · 抓取 2026-08-17 · 核验 2026-08-17
它管哪几个决定
3D 模型图生 3D / 文生 3D
0/10 家有官方说法材质与贴图PBR 贴图
0/10 家有官方说法自持能力
动手层
文档代码结构踩过的坑实测 未做
装它要过哪几关
- 1按仓库说明装依赖issue #12(47 条回复)就是 Windows 安装问题,是这个仓库最热的一条
- 2下载模型权重权重公开可下载,但许可证限制授权区域,下载前先读
改哪个文件能改什么
几何与材质两段分开做,材质可以单独重跑不用连几何一起重来坑在哪一处
带 issue 编号的来自:github issues 按回复数排序 · 核验 2026-08-17
授权区域许可证不覆盖欧盟、英国、韩国。出海产品先确认发行地
月活门槛名下产品月活合计超一百万要另行向腾讯申请授权,未获批准前不得行使协议下的权利
还活不活停更十个月。issue #111(27 条回复)在问后续版本会不会开源 —— 还没有答复
Windowsissue #12 与 #84 都是 Windows 安装,加起来七十多条回复。在 Windows 上装是这个项目的主要成本
教程
官方文档、作者本人的视频,以及 ComfyUI 官方给的原生工作流示例。每条都验过还打得开。
项目自述
以下是仓库 README 的开头部分(原文引用,抓取 2026-08-17)。读全文 ↗
[//]: # ( ) [//]: # ( ) [//]: # ( ) 🔥 News - Jul 26, 2025: 🤗 We release the first open-source, simulation-capable, immersive 3D world generation model, HunyuanWorld-1.0! - Jun 19, 2025: 👋 We present the technical report of Hunyuan3D-2.1, please check out the details and spark some discussion! - Jun 13, 2025: 🤗 We release the first production-ready 3D asset generation model, Hunyuan3D-2.1! > Join our Wechat and Discord group to discuss and find help from us. | Wechat Group | Xiaohongshu | X | Discord | 🤗 Community Contribution Leaderboard 1. By @visualbruno - ComfyUI-Hunyuan3d-2-1: https://github.com/visualbruno/ComfyUI-Hunyuan3d-2-1 2. By @VR-Jobs - Hunyuan3d-2-1 Unity Support: https://github.com/VR-Jobs/Hunyuan3D-2.1-Unity-XR-PC-Phone ☯️ Hunyuan3D 2.1 Architecture Tencent Hunyuan3D-2.1 is a scalable 3D asset creation system that advances state-of-the-art 3D generation through two pivotal innovations: Fully Open-Source Framework and Physically-Based Rendering (PBR) Texture Synthesis. For the first time, the system releases full model weights and training code, enabling community developers to directly fine-tune and extend the model for diverse downstream applications. This transparency accelerates academic research and industrial deployment. Moreover, replacing the prior RGB-based texture model, the upgraded PBR pipeline leverages physics-grounded material simulation to generate textures with photorealistic light interaction (e.g., metallic reflections, subsurface scattering). Performance We have evaluated Hunyuan3D 2.1 with other open-source as well as close-source 3d-generation methods. The numerical results indicate that Hunyuan3D 2.1 surpasses all baselines in the quality of generated textured 3D assets and the condition following ability. | Model | ULIP-T(⬆) | ULIP-I(⬆) | Uni3D-T(⬆) | Uni3D-I(⬆) | | Michelangelo | 0.0752 | 0.1152 | 0.2133 | 0.2611 | | Craftsman | 0.0745 | 0.1296 | 0.2375 | 0.2987 | | TripoSG | 0.0767 | 0.1225 | 0.2506 | 0.3129 | | Step1X-3D | 0.0735 | 0.1183 | 0.2554 | 0.3195 | | Trellis | 0.0769 | 0.1267 | 0.2496 | 0.3116 | | Direct3D-S2 | 0.0706 | 0.1134 | 0.2346 | 0.2930 | | Hunyuan3D-Shape-2.1 | 0.0774 | 0.1395 | 0.2556 | 0.3213 | | Model | CLIP-FiD(⬇) | CMMD(⬇) | CLIP-I(⬆) | LPIPS(⬇) | | SyncMVD-IPA | 28.39 | 2.397 | 0.8823 | 0.1423 | | TexGen | 28.24 | 2.448 | 0.8818 | 0.1331 | | Hunyuan3D-2.0 | 26.44 | 2.318 | 0.8893 | 0.1261 | | Hunyuan3D-Paint-2.1 | 24.78 | 2.191 | 0.9207 | 0.1211 | 🎁 Models Zoo It takes 10 GB VRAM for shape generation, 21GB for texture generation and 29GB for shape and texture generation in total. | Model | Description | Date | Size | Huggingface ……(后略,见原文)
判断
优势
- 开源侧少数明确做 PBR 材质的,直接对上引擎的光照
- 中文文档与社区最厚,国内团队上手最快
- 模型权重公开可下载
局限
- 许可证排除欧盟 / 英国 / 韩国,出海产品要先看清楚
- 月活超一百万要另行申请授权
- 本卡评估 Hunyuan3D-2.1 仓库;维护时间见仓库信息。不能把此仓库少有更新解释为整个混元 3D 产品线没有后续版本。
不适用
面向欧盟或英国市场的产品 —— 许可证不覆盖那些地区。
同管这些决定的其它项目
UltraGameStudio一个照着游戏引擎的实际工作量重写的编码 Agent:代码只是一小块,其余是材质、蓝图…VibeUE虚幻 5.8+ 的 MCP 扩展与编辑器工具集:蓝图、材质、地形、植被、动画、Nia…Blender MCP把 Blender 接到任意大模型:用对话做建模、搭场景、改物件。…TRELLIS文字或图片进,3D 资产出,可以导成辐射场、3D 高斯或网格。用一种统一的结构化隐表…PartCrafter从一张图一次生成**多个零件**和多个物体,而不是一整块网格。…TripoSG图生 3D 的基础模型,主打几何保真与泛化:照片、卡通、草图都能进。…3DTopia-XL高质量 PBR 3D 资产生成,用一种带原语的表示同时承载几何与材质。…Godogen生成游戏工程与 Agent 工作流:覆盖 Godot 4(C# 或 GDScript…AI Game Art Pipeline Skill把 AI 出的图片与视频洗成能进游戏的素材:规划、生成、清理、打包、质检 —— 覆盖…
github README + LICENSE 原文 + DeepWiki · 核验 2026-10-19 | 判断栏可报错。