Hunyuan3D‑2.1 SITES

// 01 Hunyuan3D‑2.1 是什么

Hunyuan3D‑2.1 是腾讯 Hunyuan 团队在 2025 年 6 月 13 日发布的开源工业级 3D 模型系统。它采用两阶段流水线：先生成高质量网格形状，再通过物理基础渲染 (PBR) 渲染真实材质；模型、代码、训练流程全部开源，适用于研究与工业级部署。

Hunyuan3D‑2.1 核心特点与创新功能

端到端开放平台

Hunyuan3D‑2.1 是首个发布完整权重、训练与推理代码的 3D 生成模型，降低工业应用门槛，支持 fine‑tune 与定制化开发。

PBR 材质合成，质感达电影级

系统利用物理真实渲染合成材质，支持高光、亚表面散射等光照效果，生成皮革、金属、木材等细节真实模型 。

两阶段模块：形状 + 材质

• 形状模型（Shape）：Diffusion Transformer 基于图像生成高精网格

• PBR 材质模型（Texture）：合成完整纹理贴图，支持多视角渲染。

工业级性能评测领先

在 ULIP、FID、CLIP 等量化指标上跑赢同类模型，生成结果更逼真、对齐度和一致性优于 Hunyuan3D‑2.0。

谁可以使用 Hunyuan3D‑2.1？

游戏开发者与影视动画师

生成真实感强的角色、场景、道具，节省美术建模时间，快速构建 3D 资产库。

工业设计与数字孪生

精准建模与真实材质贴图适合制造、虚拟模拟和产品可视化等工业场景。

研究者与开源社区

支持 fine‑tune、学术研究和创新，使用开放代码推动 3D AIGC 技术变革。

安装与使用指南

系统要求

• 推荐 GPU：10 GB VRAM（形状生成），21 GB VRAM（纹理合成）

• 操作系统：Windows / Linux / macOS

环境配置

安装 PyTorch (+cu124) 和 TensorFlow：

pip install torch==2.5.1 torchvision==0.20.1 torchaudio==2.5.1 --index-url pip install -r requirements.txt

示例运行流程

# 形状生成 from hy3dshape.pipelines import Hunyuan3DDiTFlowMatchingPipeline pipeline = Hunyuan3DDiTFlowMatchingPipeline.from_pretrained("tencent/Hunyuan3D-2.1") mesh = pipeline(image="demo.png")[0] 
材质渲染 from textureGenPipeline import Hunyuan3DPaintPipeline, Hunyuan3DPaintConfig paint = Hunyuan3DPaintPipeline(Hunyuan3DPaintConfig(max_num_view=6, resolution=512)) textured = paint(mesh, image="demo.png")

Gradio 演示页面启动

python gradio_app.py --model_path tencent/Hunyuan3D-2.1 --low_vram_mode

与 Hunyuan3D‑2.0 的对比升级

部署与二次开发

API 服务部署

运行 api_server.py 启用本地 8080 接口，接受 image-to-3D 请求，输出 glb 模型数据。

Blender 插件兼容

通过 Blender Add‑on，将生成模型直接导入 Blender 中进行编辑与动画制作。

Hugging Face 集成

模型权重已上传 Hugging Face ，支持 diffusers 接口和 Spaces 实时展示。

// 04 常见 问题

// 05 资料 来源