一图生成带纹理的 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。按这个基线对号入座显卡级别推荐组合预计耗时显存占用实际效果RTX 4090 等旗舰--fp16 --flashvdm --resolution 3843-5 分钟12-16 GB高细节 纹理全流程RTX 3060 / 3070--resolution 256 --steps 306-8 分钟8-10 GB中等细节纹理阶段需留意显存GTX 1660 / RTX 2060--model_path tencent/Hunyuan3D-2mini --resolution 1288-12 分钟4-6 GB用 mini 模型跑低分辨率先跑通再谈质量6 GB 以下的显卡不建议上纹理阶段显存不够时优先换 mini 模型其次降--resolution。️ 一次性装好环境编译报错先查这里环境准备分三步拉代码、装依赖、编译两个 C/CUDA 扩展模块。前两步是常规操作编译扩展是最常见的卡点因为光装 pip 依赖跑不通纹理流程。git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 cd Hunyuan3D-2pip 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(imageassets/demo.png)[0] # 阶段二纹理合成 tex_pipe Hunyuan3DPaintPipeline.from_pretrained(tencent/Hunyuan3D-2) textured_mesh tex_pipe(mesh, imageassets/demo.png)速度、质量、显存怎么权衡四个参数讲清楚调参前先理解上面的两阶段流程--enable_tex决定要不要走第二段其余参数主要作用于第一段。四个核心参数参数作用推荐值调高调低的影响--resolution输出模型分辨率128-384越高细节越多显存与耗时同步上升--steps推理步数20-50步数越多结果越稳定但线性变慢--guidance_scale引导强度5.0-10.0越高越贴近输入过高会失真--enable_tex启用纹理生成显存 ≥16GB 就开开启后追加纹理阶段是显存大头实用策略第一次跑通用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。❓ 常见问题速查问题先查什么编译 custom_rasterizer / differentiable_renderer 失败Windows 装 Visual Studio 2022 并勾选 C 桌面开发CUDA toolkit 版本与 PyTorch 匹配确认 ninja、pybind11 已安装纹理阶段显存溢出OOM--resolution降到 256 或 1286-10GB 显卡改跑tencent/Hunyuan3D-2mini小显存可加低显存模式参数生成明显偏慢换 turbo 蒸馏模型或开启--flashvdm--steps从 50 降到 20-30生成形状与输入图不像--guidance_scale提到 7-10确认输入图片主体清晰、背景干净首次运行特别慢首次会自动从模型仓库下载权重属正常现象断网/公司环境需提前准备模型文件多视角重建效果不佳前/后/左三视图保持视角正对、光照一致避免透视畸变更完整的安装说明可查 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考