企业官网建设流程全解析

一图生成带纹理的 3D 模型：Hunyuan3D-2 本地部署完整指南

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

把一张商品图拖进界面，等几分钟，得到的不是一张渲染图，而是一个带纹理的 3D 模型——可以旋转查看，也能直接拖进 Blender 继续编辑。这就是 Hunyuan3D-2 提供的 AI 3D 生成能力：一套可完全本地部署的开源 3D 建模系统，形状和纹理两个阶段全部在你的显卡上跑完，输入图片不用出内网。下面按"能不能跑 → 怎么装 → 怎么出第一个模型 → 怎么调参 → 怎么接进工作流"的顺序，带你从零跑通。

先搞清楚它能干什么：文字、图片、多视角三种入口

Hunyuan3D-2 采用两阶段生成流程：第一阶段由 Hunyuan3D-DiT 负责形状生成，根据条件产出几何结构；第二阶段由 Hunyuan3D-Paint 负责纹理合成，给这个几何结构（也可以是你自己手工建的模型）贴上高质量贴图。两个阶段解耦，所以既能"一步出成品"，也能只跑其中一段。

三种输入方式对应不同场景：

• 文本生 3D：输入一段文字描述直接生成模型，适合快速验证创意，精度相对最低；
• 图片生 3D：上传一张单视图图片，模型生成与之对齐的 3D 结构，是最常用、效果最稳的方式；
• 多视角重建：上传前、后、左三张视图，几何重建更精确，适合对还原度要求高的资产。

你的显卡跑得动吗：显存门槛与模型选择

装环境之前先看硬件，能省你一整晚的折腾。官方给出的显存基线：仅形状生成约 6 GB，形状 + 纹理全流程约 16 GB。按这个基线对号入座：

6 GB 以下的显卡不建议上纹理阶段；显存不够时优先换 mini 模型，其次降--resolution。

🛠️ 一次性装好环境，编译报错先查这里

环境准备分三步：拉代码、装依赖、编译两个 C++/CUDA 扩展模块。前两步是常规操作，编译扩展是最常见的卡点，因为光装 pip 依赖跑不通纹理流程。

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

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

编译自定义光栅化器和可微分渲染器（两个模块都要编译成功，纹理合成才能用）：

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

编译报错先查这一条：两个扩展都含 C++/CUDA 源码，Windows 上必须先装 Visual Studio 2022 并勾选"C++ 桌面开发"组件；同时确认本机 CUDA toolkit 版本与 PyTorch 要求匹配（PyTorch 建议从官网按 CUDA 版本安装）。报ninja找不到时，先执行pip install ninja pybind11再重试。Linux/Mac 同样适用上述流程，项目支持 macOS、Windows、Linux 三个平台。

⚡ 最快拿到第一个模型：启动 Gradio 界面

装完后用 Gradio 界面最快出活，不用写一行代码：

# 标准版（16GB 级显存，带纹理） python gradio_app.py --enable_tex # 轻量版（小显存显卡，mini 模型 + 128 分辨率） python gradio_app.py --model_path tencent/Hunyuan3D-2mini --resolution 128

启动后浏览器会自动打开交互界面，支持文本、单图、多视角（前/后/左视图）三种输入。

跟着做一次香蕉演示：上传仓库自带的 assets/example_images/example_000.png，参数设--resolution 256 --enable_tex，点生成，约 5-7 分钟得到一个带自然纹理和表皮褶皱的 3D 香蕉：

不想开界面，也可以直接用类 Diffusers 的 API，两段 pipeline 分别对应两个阶段：

from hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline from hy3dgen.texgen import Hunyuan3DPaintPipeline # 阶段一：形状生成 shape_pipe = Hunyuan3DDiTFlowMatchingPipeline.from_pretrained('tencent/Hunyuan3D-2') mesh = shape_pipe(image='assets/demo.png')[0] # 阶段二：纹理合成 tex_pipe = Hunyuan3DPaintPipeline.from_pretrained('tencent/Hunyuan3D-2') textured_mesh = tex_pipe(mesh, image='assets/demo.png')

速度、质量、显存怎么权衡：四个参数讲清楚

调参前先理解上面的两阶段流程：--enable_tex决定要不要走第二段，其余参数主要作用于第一段。四个核心参数：

实用策略：第一次跑通用128 + 20 步快速验证，确认输入没问题后再上256~384出成品；追求速度可换 turbo 版本模型（--flashvdm模式）。

接进你的工作流：Blender 插件和 API 服务

模型生成完只是开始，接进已有工作流更实际。

Blender 集成：先确保 API 服务在运行（插件通过它调用本地模型），然后在 Blender 3.0+ 中走"编辑 > 偏好设置 > 插件 > 安装"，选择仓库根目录的blender_addon.py；安装后在 3D 视图侧边栏找到 "Hunyuan3D-2 3D Generator" 面板，生成结果直接进入场景。

API 服务：适合把生成能力嵌进自己的网站或管线：

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

启动后通过 HTTP POST 提交图片即可取回模型文件，具体请求格式见 api_server.py。

❓ 常见问题速查

更完整的安装说明可查 docs/，多视角与纹理的高级用法见 examples/ 目录。

下一步

一句话总结：Hunyuan3D-2 把 AI 3D 生成拆成形状和纹理两段，本地部署后，从一张图片到带纹理的模型只需几分钟到十几分钟。建议从 examples/ 目录继续：shape_gen.py是最简形状生成，textured_shape_gen.py加上了纹理阶段，shape_gen_multiview.py和textured_shape_gen_multiview.py演示多视角输入；想一次性体验完整链路，直接跑根目录的minimal_demo.py。

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