Hunyuan3D-2 AI 3D模型生成本地部署指南：十分钟从零跑通文生3D与图生3D-平芜编程栈

Hunyuan3D-2 AI 3D模型生成本地部署指南：十分钟从零跑通文生3D与图生3D

【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2

Hunyuan3D-2 是腾讯开源的 AI 3D模型生成工具，吃进一段文字描述或一张图片，吐出一个可直接下载、可直接编辑的 3D 模型（GLB）。游戏美术、电商设计师、想给自己的 App 加 3D 能力的开发者，以及纯粹好奇"AI 到底能不能建模"的人，都值得花十分钟在本地把它跑起来。

先看效果：它能画到什么程度

先看结果，再决定要不要动手：

官方放出的生成样本覆盖了卡通角色、建筑场景、文物复刻、奇幻生物。它不是玩具级 demo：形状由 Hunyuan3D-DIT 去噪 Transformer 生成，纹理由 Hunyuan3D-Paint 补上，两阶段串行，所以出来的网格能进 Blender 继续精修，纹理也不会糊成一片。能力边界也实话实说——它生成的是"资产级"模型而非照片级写实，细节精度随参数（分辨率、推理步数、八叉树分辨率）上下浮动。这个两阶段分工直接决定了后面所有调参逻辑：

下面进入部署。按顺序走完，Windows 环境下十分钟以内能出第一个模型。

十分钟部署：从自检到编译完成

1. 环境自检

先把四样东西核对一遍，缺一样后面都会卡：

操作系统：Windows 10/11 64 位
Python 3.10.x（推荐 3.10.9）
Visual Studio 2022，且装上了"C++ 桌面开发"组件（MSVC + Windows SDK）
NVIDIA 显卡，RTX 3060 及以上推荐；16GB 内存；20GB 可用磁盘

⚙️常见坑：VS 2022 光装本体不够，安装器里必须勾中"C++ 桌面开发"。很多"编译报错找不到头文件"，根因就是这一步漏装，补装完组件再重跑编译。

2. 获取代码并装依赖

克隆仓库并进入目录：

git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 cd Hunyuan3D-2

装依赖前建议开个虚拟环境，避免污染系统 Python：

python -m venv venv venv\Scripts\activate pip install -r requirements.txt

依赖冲突多半是环境混装导致的，虚拟环境能消掉这类噪音。

3. 编译两个 C++ 扩展

纹理生成链路上有两块 C++ 核心：自定义光栅化器（负责 3D 渲染）和可微分渲染器（负责纹理生成）。逐个编译：

cd hy3dgen/texgen/custom_rasterizer python setup.py install cd ../../..

cd hy3dgen/texgen/differentiable_renderer python setup.py install cd ../../..

🔧小提示：如果报错cl.exe not found，别去下载编译器——以管理员身份启动"x64 Native Tools Command Prompt for VS 2022"，在这个窗口里重跑上面两条编译命令即可。

到这一步，部署完成。接下来按你的使用习惯，从三条路里挑一条。

三种打开方式：界面、插件、API

给点鼠标的新手：Gradio 界面

启动本地可视化界面：

python gradio_app.py --enable_tex

浏览器自动打开页面，界面上有三种生成模式：

文本生成：直接输入描述，例如"一座蓝色屋顶的卡通风格小房子"，等它出网格；
图片转 3D：上传单张图片生成对应 3D 模型，assets/example_images/里备好了大量示例图可以直接拿来试；
多视角合成：上传前、后、左、右多个角度的图片，融合多视角信息后结构更准，适合手里有多张照片的实物场景。

给 Blender 老用户：插件集成

不想离开 Blender 的，把能力直接挂进去：

打开 Blender 3.0+
编辑 > 偏好设置 > 插件
点"安装"，选择项目里的blender_addon.py
启用后在 3D 视图侧边栏找到"Hunyuan3D-2 3D Generator"面板

之后文本或图像生成的结果会自动导入当前场景，生成只是工作流第一步，剩下的雕刻、材质、动画照旧在 Blender 里做。

给要接 API 的开发者：服务调用

起一个常驻服务：

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

用curl调一次/generate端点就能拿到模型。先用仓库自带的示例图编码：

img_b64_str=$(base64 -i assets/demo.png)

再发请求，结果直接落盘成 GLB：

curl -X POST "http://localhost:8080/generate" \ -H "Content-Type: application/json" \ -d '{"image": "'"$img_b64_str"'", "texture": true}' \ -o output.glb

把它包一层客户端，就是你产品里的"AI 3D模型生成"能力。

调参自救：按显卡档位定参数

硬件选型参数表

参数别乱堆，按显卡档位对号入座：

硬件配置	推荐参数组合	生成时间	模型质量
RTX 4070 以上	`--fp16 --flashvdm --resolution 384`	3-5 分钟	高
RTX 3060	`--steps 30 --resolution 256`	5-8 分钟	中
GTX 1660	`--model_path tencent/Hunyuan3D-2mini --resolution 128`	2-4 分钟	基础

高级参数

两个真正决定输出形态的参数：

--octree_resolution：模型细节精度，默认 256。调高细节更满，显存占用同步上涨；
--guidance_scale：结果对输入描述的贴合度。5.0–10.0 区间内，越高越"听话"，但多样性下降。

三个高频症状

症状 1：CUDA out of memory解法：降分辨率（--resolution 128），或换 mini 模型（--model_path tencent/Hunyuan3D-2mini），也可以先关纹理生成（去掉--enable_tex）把形状跑通。

症状 2：C++ 扩展编译提示缺少头文件解法：检查 Visual Studio 2022 是否装了"C++ 桌面开发"组件（MSVC 编译器 + Windows SDK），装完重跑python setup.py install。

症状 3：纹理发糊、细节不够解法：加推理步数（--steps 50）或提分辨率（--resolution 384），再用--texture_guidance_scale 7.5单独压纹理细节。

命令速查

操作	命令
安装依赖	`pip install -r requirements.txt`
编译光栅化器	`cd hy3dgen/texgen/custom_rasterizer && python setup.py install && cd ../../..`
编译渲染器	`cd hy3dgen/texgen/differentiable_renderer && python setup.py install && cd ../../..`
启动 Gradio 界面	`python gradio_app.py --enable_tex`
启动 API 服务	`python api_server.py --host 0.0.0.0 --port 8080 --enable_tex`

更多细节在官方文档和示例脚本里。打开终端，把第一条 clone 命令跑起来，剩下的交给显卡。

【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考