- Hunyuan3D 2.0 是腾讯混元的开源 3D 资产生成系统,2025年1月21日发布,输入图像或文本,输出高分辨率带纹理的 3D 网格,可保存为 glb/obj
- 采用两阶段流水线:Hunyuan3D-DiT 先生成形状,Hunyuan3D-Paint 再合成纹理,相当于先出白模再贴皮
- 官方 benchmark 四项指标均超过当时的开源与闭源基线:CMMD 3.193、FID_CLIP 49.165、FID 282.429、CLIP-score 0.809(官方自测口径)
- 本地部署门槛:形状生成约需 6GB 显存,形状加纹理约 16GB,支持 low_vram_mode;提供 Gradio、API Server、Blender 插件与 ComfyUI 第三方集成
- 许可证为 Tencent Hunyuan 3D 2.0 Community License,不是 OSI 认可的开源许可:不适用于欧盟、英国、韩国,月活超 100 万需另行授权,不得用其改进其他 AI 模型
- 系列后续 Hunyuan3D 2.1(2025年6月,PBR 与训练代码全量开源)与 Hunyuan3D 3.0(2025 年下半年)已发布,2.0 适合自部署学习与预生产测试
Hunyuan3D 2.0 是什么:从一张图到带纹理的 3D 模型
Hunyuan3D 2.0 是腾讯混元团队发布的 3D 资产生成系统,一句话概括它的链路:输入一张图片或一段文字,输出一个可以直接拖进游戏引擎、建模软件或渲染器的带纹理 3D 模型。官方文档对它的定义是"大规模 3D 资产生成系统",主打高分辨率与完整纹理。
实际使用中,图像输入是主路径:给一张参考图,系统生成与该图几何对齐的网格,再自动铺上高分辨率纹理。输出是 trimesh 对象,可保存为 glb、obj 等格式。想快速体验的话,官方提供了在线站点 Hunyuan3D Studio 与 HuggingFace Demo,不用本地部署就能跑;本文后面会讲本地部署方式。
核心技术:形状生成加纹理合成,两阶段解耦
两阶段流水线是 Hunyuan3D 2.0 最核心的设计,理解它可以用建模师的工作流类比:先在软件里搭出白模,再展开 UV 贴材质。系统把这两步拆给两个专用模型,避免"一个模型同时搞定形状和纹理"带来的难度耦合。
第一阶段由形状生成模型 Hunyuan3D-DiT 负责,它基于可扩展的 flow-based diffusion transformer,输入条件图像,生成与该图像对齐的几何。论文(arXiv 2501.12202)描述它"为下游应用打下几何基础"。第二阶段由纹理合成模型 Hunyuan3D-Paint 负责,它借助几何与扩散先验,为网格生成高分辨率、色彩饱满的纹理贴图,既能为生成模型贴皮,也能给手工建模的网格补纹理。
官方在自测中对比了当时的开源与闭源 3D 生成方法,Hunyuan3D 2.0 在四项指标上全部领先:CMMD 3.193(越低越好)、FID_CLIP 49.165、FID 282.429、CLIP-score 0.809(越高越好)。需要注意,这是官方自测口径,不是第三方独立评测。
适用场景与效果边界
从能力定位看,Hunyuan3D 2.0 适合游戏与动画的预生产阶段、电商商品图转 3D、快速概念验证这类场景。官方 benchmark 显示的强项是几何细节、条件对齐与纹理质量;模型家族还提供 mini(0.6B)与 mv(1.1B 多视图)版本,分别对应低显存与多视角输入需求。
效果边界要诚实说。社区实际体验中,Reddit r/StableDiffusion 上有用户评价:把它当作预生产阶段的基础模型快速出稿是可以的,但输出"还没达到我习惯在最终产品中看到的资产质量"。人脸、生物特征与复杂拓扑仍是 3D 生成模型的普遍短板。硬件门槛也不低:形状生成约需 6GB 显存,形状加纹理合计约 16GB。
许可证是容易被忽略的边界。Hunyuan3D 2.0 使用 Tencent Hunyuan 3D 2.0 Community License,并非 OSI 认可的开源许可:协议不适用于欧盟、英国与韩国;若你的产品月活超过 100 万,需要向腾讯另行申请授权;条款还禁止用该模型改进其他 AI 模型。商业落地前务必读完整份 LICENSE。
快速上手:部署与使用
前置条件:一台装有 Linux、Windows 或 macOS 的机器,Python 环境,按 PyTorch 官网安装对应版本的 PyTorch,显存建议 16GB 以上(纹理流程),低配机器可开 low_vram_mode。模型权重从 HuggingFace 下载。
安装依赖与项目本体:
代码调用采用 diffusers 风格 API,先用形状模型生成网格,再用纹理模型贴皮:
想用图形界面,直接启动 Gradio App:
成功验证的标准是输出 trimesh 对象并能保存为 glb/obj。常见失败集中在三处:显存不足(换 mini 模型或开 low_vram_mode);custom_rasterizer 与 differentiable_renderer 编译失败(需要 CUDA 工具链与匹配的 PyTorch 版本);首次运行从 HuggingFace 下载权重较慢。Turbo 版(Hunyuan3D-2-Turbo)可显著缩短推理步数,配合 FlashVDM 使用。
在混元 3D 生态中的定位
Hunyuan3D 系列从 1.0(2024年11月)起步,2.0 在 2025年1月开源推理代码与预训练权重,随后演进到 2mv/2mini/2-Turbo(2025年3月)、2.1(2025年6月,PBR 材质模型、VAE 编码器与全部训练代码全量开源)、2.5(技术报告)与 3D 世界生成模型 HunyuanWorld-1.0(2025年7月)。2025 年下半年,腾讯又发布 Hunyuan3D 3.0,主打更高精度(几何分辨率 1536 立方、3.6B voxel 建模)与更逼真的人脸轮廓,并开放 Hunyuan 3D AI Engine 使用。
对开发者而言,2.0 的价值在于它是系列中第一个完整可自部署的版本,代码与权重全部开放,适合学习 diffusion 3D 生成管线、做二次开发,或离线批量生成。对比 Tripo、Meshy 这类开箱即用的商业产品,2.0 的部署成本更高,但胜在可控与可学习。需要 PBR 材质和生产级纹理,应直接看 2.1;追求最高精度,用 3.0 的在线引擎。2.0 的定位更接近"可自部署的基线模型",而不是最新最强。