Hunyuan3D-2 本地部署实操教程：图像转3D，5分钟出第一个模型

Hunyuan3D-2 本地部署实操教程：图像转3D，5分钟出第一个模型

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

Hunyuan3D-2 把"图片转 3D 模型"搬到了你自己的机器上：喂一段文字、一张图或一组多视角图，拿回的是一枚可 360° 查看的 glb 模型。整条流程本地跑完，形状生成最低 6GB 显存即可启动，适合内容创作者、3D 爱好者和想把生成能力接进自己应用的开发者。

一、部署前环境清单

⚠️ 唯一容易漏的一步：编译前确认终端里g++（或cl.exe）在 PATH 中可用，否则后面的 setup 脚本会直接报错。

二、最小命令跑通第一个结果

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

拉取源码并进入项目目录。

pip install -r requirements.txt pip install -e .

装好依赖并把 hy3dgen 包以可编辑模式装进环境。

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

按此顺序编译自定义光栅化器和可微分渲染器两个 C++ 扩展。

python gradio_app.py --model_path tencent/Hunyuan3D-2mini --subfolder hunyuan3d-dit-v2-mini --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode

用 0.6B 的 mini 模型加--low_vram_mode启动 Gradio 页面，浏览器打开后上传assets/example_images/example_000.png（仓库自带的一根香蕉）或输入一句文字描述，点生成，几分钟内就能看到第一枚 3D 模型。

原理一句话：Hunyuan3D-2 内部先由形状扩散模型出"裸"网格，再由纹理合成模型给网格贴皮，两步解耦，生成的或手做的网格都能直接上色。

三、三种用法对照：按需求选入口

Gradio 界面：文本、单图、多视角三套输入 Tab 都在页面上。试多视角时，assets/example_mv_images/1/里放好了 front / back / left 三张现成示例，照着上传即可。

API 服务：服务起来后，图片转 base64 发个 POST 就能拿到模型文件：

img_b64_str=$(base64 -i assets/example_images/example_002.png) curl -X POST "http://localhost:8080/generate" \ -H "Content-Type: application/json" \ -d '{"image": "'"$img_b64_str"'", "texture": true, "resolution": 256}' \ -o output_model.glb

Blender 插件：在 Blender 3.0+ 的"编辑 → 偏好设置 → 插件"里点"安装"，选blender_addon.py并启用，之后 3D 视图侧边栏会出现 "Hunyuan3D-2 3D Generator" 面板，生成的模型直接落进场景。

四、参数与硬件速查

显存档位（官方 Model Zoo 口径）：

常用参数（Gradio 界面滑块 / 代码调用参数）：

• 先 128 低档快速看个大概，参数调顺了再上 256 出成品，能省掉大量等待时间。
• 显存告急优先挂--low_vram_mode；追求出图速度则给形状模型加--enable_flashvdm并选 turbo 子目录。
• mini（0.6B）、mv 多视角（1.1B）、标准 2.0（1.1B + 1.3B 纹理）三档模型按需选，详见 docs/modelzoo.md。

五、完整实例：一张海豚图变成 3D 模型

六、踩坑速查

收尾：命令速查卡

git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 pip install -r requirements.txt && pip install -e . cd hy3dgen/texgen/custom_rasterizer && python setup.py install cd hy3dgen/texgen/differentiable_renderer && python setup.py install python gradio_app.py --model_path tencent/Hunyuan3D-2 --subfolder hunyuan3d-dit-v2-0 --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode python api_server.py --host 0.0.0.0 --port 8080 --enable_tex

下一步：

• 打开 examples/ 目录，挑shape_gen_multiview.py、textured_shape_gen_multiview.py跑通多视角管线。
• 翻一遍 docs 里的 started 章节（gradio / code / studio / blender），对照实际场景补细节。
• 想给现有网格上色而不是从头生成，试试examples/textured_shape_gen.py的手作网格贴纹理路线。

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