Hunyuan3D-2.1：一张图片生成带 PBR 材质的 3D 模型，安装与试用教程

图片来源：Tencent Hunyuan3D-2.1 官方 GitHub README。资料核对时间：2026-06-11。

如果你关注室内设计、家具建模、游戏资产或电商 3D 展示，Hunyuan3D-2.1 是最近很值得看的开源项目。它的定位不是单纯“图片转模型”，而是从图片生成带纹理、可用于生产流程的 3D 资产，重点能力包括 Image-to-Shape、PBR 材质生成 和可导出的 3D 模型。

项目地址：
https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1

在线体验：
https://huggingface.co/spaces/tencent/Hunyuan3D-2.1

模型地址：
https://huggingface.co/tencent/Hunyuan3D-2.1

它解决什么问题？

传统 3D 资产制作需要建模、UV、贴图、材质、打光，门槛高、周期长。Hunyuan3D-2.1 的价值在于：给它一张物体图片，它可以生成一个可继续处理的 3D 资产。

这对室内设计尤其有用：

• 把单张家具图转成 3D 资产，放进 Blender、Unity 或空间方案里测试比例。
• 把灯具、椅子、摆件、装饰品快速做成可预览模型。
• 为软装方案、产品展示、电商详情页生成基础 3D 素材。
• 给设计师一个“先出模型，再人工修”的起点。

核心亮点：PBR 材质

Hunyuan3D-2.1 的 README 强调它从 RGB 纹理升级到 Physically-Based Rendering，PBR 材质管线。简单说，PBR 不只是把图片贴在模型上，而是让材质具备更接近真实渲染的属性，例如金属感、粗糙度、反射和光照响应。

这就是它和普通“粗糙图生 3D”工具最大的差异：如果后续要放到 Blender、Unity、Unreal 或 Web 3D 场景里，PBR 材质会更容易接入实际渲染流程。

显卡要求

官方 README 给出的显存参考：

• 形状生成：约 10GB VRAM
• 纹理生成：约 21GB VRAM
• 形状 + 纹理完整流程：约 29GB VRAM

也就是说，如果只是体验图生形状，中高端显卡可能还能尝试；如果要完整生成 PBR 纹理，建议使用更高显存 GPU，或者直接用 Hugging Face 在线 Demo。

本地安装教程

官方测试环境是 Python 3.10 和 PyTorch 2.5.1 + CUDA 12.4。

git clone https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1.git
cd Hunyuan3D-2.1

pip install torch==2.5.1 torchvision==0.20.1 torchaudio==2.5.1 --index-url https://download.pytorch.org/whl/cu124
pip install -r requirements.txt

然后安装自定义渲染和绘制依赖：

cd hy3dpaint/custom_rasterizer
pip install -e .
cd ../..

cd hy3dpaint/DifferentiableRenderer
bash compile_mesh_painter.sh
cd ../..

下载 Real-ESRGAN 权重：

wget https://github.com/xinntao/Real-ESRGAN/releases/download/v0.1.0/RealESRGAN_x4plus.pth -P hy3dpaint/ckpt

启动 Gradio 本地界面

如果你想用网页界面体验，可以运行：

python3 gradio_app.py \
  --model_path tencent/Hunyuan3D-2.1 \
  --subfolder hunyuan3d-dit-v2-1 \
  --texgen_model_path tencent/Hunyuan3D-2.1 \
  --low_vram_mode

启动后浏览器会显示一个本地地址，打开后上传图片即可生成 3D 模型。

室内设计怎么用？

推荐先从这些素材开始：

• 单一家具：椅子、桌子、边几、灯具。
• 软装小物：花瓶、摆件、香薰、挂件。
• 产品图：干净背景、主体完整、无遮挡。

提示词和图片选择建议：

• 尽量使用单一物体图片，避免复杂背景。
• 物体不要被裁切，边缘越完整越好。
• 如果要做室内方案资产，先生成模型，再进 Blender 做比例和材质微调。
• 不要直接把生成模型当最终交付文件，最好经过人工检查拓扑、法线和材质。

适合谁？

室内设计师：快速把家具或软装图转成 3D 草模，用于方案探索。
电商团队：为产品展示生成基础 3D 资产。
游戏/VR 创作者：快速获得可修改的资产初稿。
AI 工具玩家：体验图生 3D 的最新开源能力。

注意事项

• Hunyuan3D-2.1 的训练代码和模型权重是项目核心亮点，但使用前仍建议查看仓库 License 和模型页面条款。
• 完整 PBR 生成对显存要求较高，普通笔记本建议先用在线 Demo。
• AI 生成模型可能存在拓扑不干净、比例不准、细节糊的问题，生产使用前需要人工修模。

资料来源

• GitHub：https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1
• Hugging Face Demo：https://huggingface.co/spaces/tencent/Hunyuan3D-2.1
• Hugging Face Models：https://huggingface.co/tencent/Hunyuan3D-2.1
• Technical Report：https://arxiv.org/pdf/2506.15442
• 图片来源：Tencent Hunyuan3D-2.1 官方 README