Hunyuan3D-2：腾讯开源的高分辨率3D模型生成工具-首席AI分享圈

🚀邀请体验：中国首家 AI IDE 智能编程软件 Trae 中文版下载，不限量使用 DeepSeek-R1 和 Doubao-pro!

综合介绍

Hunyuan3D-2 是腾讯开发的一个开源项目，旨在通过文字或图像生成高分辨率的3D模型。它由两个核心部分组成：形状生成模型（Hunyuan3D-DiT）和纹理生成模型（Hunyuan3D-Paint）。用户可以输入文字描述或上传图片，生成带有细节纹理的3D数字资产。这个工具在 GitHub 上免费提供代码和预训练模型，最新版本于2025年3月18日更新。它支持多种型号，包括快速版和迷你版，适合不同设备使用。Hunyuan3D-2 被广泛应用于游戏开发、数字艺术和研究领域。

Hunyuan3D-2：腾讯开源的高分辨率3D模型生成工具-1

功能列表

支持从文字生成3D模型，用户输入描述即可生成对应几何形状。
支持从图像生成3D模型，上传图片后生成带纹理的3D资产。
提供高分辨率输出，模型细节清晰，纹理色彩鲜艳。
包含形状生成模型（Hunyuan3D-DiT），负责生成基础几何结构。
包含纹理生成模型（Hunyuan3D-Paint），为模型添加高分辨率纹理。
支持多视图生成（Hunyuan3D-2mv），从多个角度优化模型。
提供迷你版模型（Hunyuan3D-2mini），参数量仅0.6亿，运行更快。
支持快速版模型（Fast），推理时间减半，效率更高。
可集成Blender，通过插件直接生成和编辑3D模型。
开源代码和模型，用户可自由下载和修改。

使用帮助

Hunyuan3D-2 是一个功能强大的工具，需要一定的硬件和编程基础。以下是详细的安装和使用指南，帮助用户快速上手。

安装流程

准备硬件和软件环境
- 需要 NVIDIA GPU，支持 CUDA，显存至少 6GB（迷你版）或 12GB（标准版）。
- 安装 Python 3.9 或以上版本。
- 安装 Git，用于下载代码。

下载代码和模型

在终端运行：

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

从 Hugging Face 下载预训练模型：

huggingface-cli download tencent/Hunyuan3D-2 --local-dir ./weights

安装依赖

安装基本依赖：
```
pip install -r requirements.txt
```

为纹理生成安装额外模块：

cd hy3dgen/texgen/custom_rasterizer
python3 setup.py install
cd ../../..
cd hy3dgen/texgen/differentiable_renderer
python3 setup.py install

可选安装 Flash Attention 加速：

pip install ninja
pip install git+https://github.com/Dao-AILab/flash-attention.git@v2.6.3

验证安装
- 运行示例代码：
```
python minimal_demo.py
```
- 如果成功输出模型，说明安装完成。

主要功能操作

1. 从图像生成3D模型

步骤：

准备一张图片（如 demo.png），放在 assets 文件夹。

生成基础形状：

from hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline
from PIL import Image
pipeline = Hunyuan3DDiTFlowMatchingPipeline.from_pretrained('tencent/Hunyuan3D-2')
image = Image.open('assets/demo.png')
mesh = pipeline(image=image, num_inference_steps=30)[0]
mesh.export('output.glb')

添加纹理：

from hy3dgen.texgen import Hunyuan3DPaintPipeline
pipeline = Hunyuan3DPaintPipeline.from_pretrained('tencent/Hunyuan3D-2')
mesh = pipeline(mesh, image=image)
mesh.export('textured.glb')

结果：生成带纹理的3D模型，保存为 .glb 文件。

2. 从文字生成3D模型

步骤：

安装文字到图像模块（HunyuanDiT）：

huggingface-cli download Tencent-Hunyuan/HunyuanDiT-v1.1-Diffusers-Distilled --local-dir ./weights/hunyuanDiT

运行代码：

from hy3dgen.text2image import HunyuanDiTPipeline
from hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline
t2i = HunyuanDiTPipeline('Tencent-Hunyuan/HunyuanDiT-v1.1-Diffusers-Distilled')
i23d = Hunyuan3DDiTFlowMatchingPipeline.from_pretrained('tencent/Hunyuan3D-2')
image = t2i('a cute rabbit')
mesh = i23d(image, num_inference_steps=30)[0]
mesh.export('rabbit.glb')

结果：根据文字生成3D模型。

3. 使用Gradio界面

步骤：

运行Gradio应用：

python3 gradio_app.py --model_path tencent/Hunyuan3D-2 --subfolder hunyuan3d-dit-v2-0 --texgen_model_path tencent/Hunyuan3D-2

打开浏览器，访问提示的本地地址。
上传图片或输入文字，点击生成。

结果：通过网页界面生成模型，无需编写代码。

4. 使用API服务

步骤：

启动API服务器：

python api_server.py --host 0.0.0.0 --port 8080

发送请求生成模型：

img_b64_str=$(base64 -i assets/demo.png)
curl -X POST "http://localhost:8080/generate" \
-H "Content-Type: application/json" \
-d '{"image": "'"$img_b64_str"'"}' \
-o test.glb

结果：通过API生成3D模型。

5. 使用Blender插件

安装：
- 下载 blender_addon.py 文件。
- 打开Blender，在“编辑 > 偏好设置 > 插件”中安装并启用。
操作：
- 启动API服务器（见上）。
- 在Blender侧边栏找到“Hunyuan3D-2”。
- 输入文字或上传图片，点击生成。
结果：直接在Blender中生成并编辑模型。

特色功能操作

多视图生成（Hunyuan3D-2mv）

使用命令：

pipeline = Hunyuan3DDiTFlowMatchingPipeline.from_pretrained('tencent/Hunyuan3D-2mv', subfolder='hunyuan3d-dit-v2-mv')
mesh = pipeline(image=Image.open('assets/demo.png'))[0]
mesh.export('mv_model.glb')

适合需要多角度精确建模的场景。

快速生成（Hunyuan3D-2mini）

使用命令：

pipeline = Hunyuan3DDiTFlowMatchingPipeline.from_pretrained('tencent/Hunyuan3D-2mini', subfolder='hunyuan3d-dit-v2-mini')
mesh = pipeline(image=Image.open('assets/demo.png'))[0]
mesh.export('mini_model.glb')