企业官网建设流程全解析

Hunyuan3D-2 本地部署完整指南：两阶段跑通 AI 建模，一张图出带纹理 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 形状，再给模型上色，产出一个可以直接拿走的带纹理模型。全程不需要你会建模，一台装了 NVIDIA 显卡的 Windows 电脑就够了。

先确认机器够不够用

部署前对一下清单：

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

够用的话，直接克隆仓库：

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

装 Python 依赖：冲突了就用虚拟环境

pip install -r requirements.txt

跑这条命令遇到依赖冲突是新手最常卡的第一个点。别反复试，直接建一个干净环境再装：

python -m venv venv venv\Scripts\activate # Windows系统 pip install -r requirements.txt

装完依赖，还差两个 C++ 扩展没编译，下一节说。

编译两个 C++ 扩展：cl.exe 报错的解法

纹理生成依赖两个编译好的本地组件，必须各跑一次：

光栅化器（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"，在那个窗口里把上面两段命令重新执行一遍即可。前提是 VS 2022 装了 C++ 桌面开发组件（含 MSVC 编译器和 Windows SDK）。

两处都装完，就能启动了。

一条命令拉起 Gradio 界面

python gradio_app.py --enable_tex

浏览器自动打开界面，三种生成入口都在这一个页面上：

• 文本模式：输入描述直接生成。试试"一座蓝色屋顶的卡通风格小房子"。

• 图片模式：上传单张图生成对应 3D 模型。示例图都在assets/example_images/目录下，随便挑一张就能跑：

• 多视角模式：上传物体前、后、左、右不同角度的图，系统融合多视角信息，生成的 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 之间，越高越贴、越没惊喜

显存不够：三个降配方案

生成时报 "CUDA out of memory" 不用慌，按顺序试：

1. 降分辨率：--resolution 128
2. 换 mini 模型：--model_path tencent/Hunyuan3D-2mini
3. 关掉纹理生成：去掉--enable_tex

三招都做完还爆，就只能等换显卡了。

纹理发糊：三个提画质旋钮

反过来，模型能跑但纹理不够清楚时：

• 增加推理步数：--steps 50
• 提高分辨率：--resolution 384
• 试试--texture_guidance_scale 7.5，强化纹理细节

一个输入-参数-产出的最短示范：图片模式上传雕塑图（可用assets/example_images/075.png），步数 30、分辨率 256、开纹理，约 5 分钟出成品。

Blender 插件：结果直接进场景

习惯 Blender 的用户不用在浏览器和软件之间倒文件。打开 Blender（3.0 以上），进"编辑>偏好设置>插件"，点"安装"选中项目里的blender_addon.py，启用后在 3D 视图侧边栏找 "Hunyuan3D-2 3D Generator" 面板，用文本或图片生成，结果自动导入当前场景。

API 服务：把生成能力接进自己的程序

要集成到自己的应用里，起一个 API 服务：

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

用 curl 发一张图就能拿到 GLB 文件：

# 读取图片并编码 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"'", "texture": true}' \ -o output.glb

服务起来后 Blender 插件也连着它工作，生成即所得。

模型权重去哪了、去哪看更多

• 权重不用手动下，首次启动联网自动拉取
• 进阶写法（多视角、给现成网格上纹理）在 examples/ 里逐个文件看
• 完整文档在 docs/

现在克隆仓库，把第一个带纹理的模型跑出来。

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