Hunyuan3D-2 完全指南:一张图生成带纹理 3D 资产 📅 发布时间:2026/9/12 13:03:38 👁 浏览次数: Hunyuan3D-2 完全指南一张图生成带纹理 3D 资产【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2把一张照片变成能直接放进游戏、网页或电商场景的高分辨率 3D 资产传统流程要建模、展 UV、画贴图一个资产耗时以天计。Hunyuan3D-2 是腾讯开源的大规模 3D 资产生成系统它把这件事压缩成图片进、带纹理的 3D 网格出并完整开放了推理代码、模型权重与技术报告。一、为什么 3D 资产还靠手搓三条老路都不省心如果你需要 3D 资产大概率走过这三条路每条都有硬伤手工建模质量可控但一个中等复杂度的模型从建模到贴图要几天外包预算以千元计商业闭源 API按量付费且资产数据要过第三方早期开源图生 3D几何粗糙、纹理发灰出图即报废Hunyuan3D-2 的切入点是质量打平闭源、代码全部开源官方基准测试里它在 FID、CLIP-score 等指标上超过了此前所有开源与闭源基线而推理代码、模型权重、技术报告、ComfyUI 支持和微调能力均已开放。二、⚡️ 30 秒看懂它先雕形状后上皮肤Hunyuan3D-2 的核心是一条两步流水线Hunyuan3D-DiT 先生成裸网格Hunyuan3D-Paint 再为网格合成高分辨率纹理。拆开看形状阶段Hunyuan3D-DiT 是一个基于流匹配的扩散 Transformer输入一张条件图输出与原图几何对齐的 3D 网格纹理阶段Hunyuan3D-Paint 输入网格和原图生成高分辨率纹理贴图贴回网格表面解耦的红利两个阶段互相独立贴图流程既能作用于生成的网格也能作用于你自己手工做的网格这个形状与纹理分家的设计是后面很多用法的基础记住它。三、仓库地图8 个入口各管一件事仓库结构不复杂记住下面这张表任何时候打开仓库都不会迷路路径是什么什么时候用它minimal_demo.py最短完整示例去背景、生成形状、贴图、导出第一次跑通全链路gradio_app.py本地网页交互界面不想写代码鼠标点点点api_server.py本地推理 API 服务集成进自己的业务系统blender_addon.pyBlender 插件在 3D 软件工作流内直接生成examples/11 个进阶脚本多视角输入、Turbo 加速、单独贴图hy3dgen/核心库含shapegen/与texgen/读源码、二次开发docs/source/started/7 篇使用文档code、api、gradio、blender、comfyui 等卡住时按场景查assets/example_images/50 多张示例输入图手上没素材时拿来试四、 5 分钟装好克隆、装依赖、跑通第一个 3D 资产系统支持 macOS、Windows、Linux。按下面 4 步走克隆仓库git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2装依赖先按官方指南装好 PyTorch然后执行pip install -r requirements.txt和pip install -e .。如果你要纹理功能还需编译两个光栅化组件分别在hy3dgen/texgen/custom_rasterizer和hy3dgen/texgen/differentiable_renderer下执行python3 setup.py install模型自动下载代码里写tencent/Hunyuan3D-2这个模型名首次运行会自动拉取权重不用手动搬模型文件跑通直接运行minimal_demo.py它读的是仓库自带的assets/demo.png走完形状生成、纹理合成导出demo.glb 提醒Hunyuan3D-2 采用腾讯混元非商业许可协议商用部署前请先阅读仓库根目录的LICENSE确认边界。五、4 种上手姿势网页、代码、API、Blender同一个仓库给了你 4 个入口按场景挑不用全都会网页交互最省力运行gradio_app.py启动本地 Gradio 页面浏览器里上传图、点按钮、下载 glb。显存紧张时加--low_vram_mode参数细节见docs/source/started/gradio.md三行代码最灵活API 设计成 diffusers 风格——Hunyuan3DDiTFlowMatchingPipeline.from_pretrained(tencent/Hunyuan3D-2)加载形状模型传入图片路径即得网格输出是 trimesh 对象一行mesh.export(demo.glb)落盘。纹理同理加载Hunyuan3DPaintPipeline再跑一遍API 服务最适合集成api_server.py --port 8080起服务后用 HTTP 请求即可图进 3D 出适合挂到自己的产品后端文档见docs/source/started/api.mdBlender 插件最适合设计师先起 API 服务再安装blender_addon.py在 Blender 里直接调用生成文档见docs/source/started/blender.md模型不是越大越好按你的显存和输入类型选你的场景推荐模型规模显存 6GB 左右、快速试水Hunyuan3D-2mini0.6B标准单图生 3DHunyuan3D-DiT-v2-01.1B正/背/侧多张照片输入Hunyuan3D-DiT-v2-mv1.1B追求生成速度对应系列的 Turbo 蒸馏版0.6B~1.1B纹理统一用 Hunyuan3D-Paint-v2-01.3B赶时间就换它的 Turbo 版。 提示显存参考线——只生成形状约 6GB形状加纹理全流程约 16GB。Turbo 系列还可以开--enable_flashvdm进一步省步数、提速。六、 3 个容易被忽略的隐藏能力README 篇幅有限几个高价值用法值得单独点名给你现有的模型贴纹理正因为贴图与生成解耦Hunyuan3D-Paint 接受任何网格作为输入——你手工建模的 obj、glb 都能直接上皮肤参考examples/里的纹理脚本多视角输入更稳assets/example_mv_images/内置 14 组示例每组含 front、back、left 三张图配合 mv 系列模型从 3 张照片重建的几何一致性明显更好浏览器直接预览assets/modelviewer-template.html是个现成的预览页拖入生成的 glb 即可旋转查看不用装任何软件另有纹理增强与去光照delight模型以及 ComfyUI 接入说明docs/source/started/comfyui.md想接节点工作流可以顺手看完七、❓ 常见问题显存不够、只想贴图、怎么跟进更新显存只有 6GB能跑吗能出形状。6GB 显存足以跑形状生成要连纹理一起出建议上 Hunyuan3D-2mini 并在 Gradio 里加--low_vram_mode。不想重新生成形状只想给现有模型贴图可以。把已有网格喂给Hunyuan3DPaintPipeline再配一张参考图即可这也是两步流水线解耦带来的直接好处examples/下有对应的贴图脚本。输出的 glb 文件怎么预览、怎么进工作流代码输出的是 trimesh 对象可导出 glb、obj 等常见格式预览用仓库自带的assets/modelviewer-template.html进 Blender 直接导入 glb 即可。项目还会更新吗怎么跟进仓库 README 顶部有 News 时间线开源计划清单里推理代码、权重、报告、ComfyUI、微调均已打勾TensorRT 版本在路。定期git pull拉取即可。Hunyuan3D-2 的价值一句话把一张图到可用 3D 资产的距离从几天压缩到几分钟而且全流程开源可改。你的第一步克隆仓库装好依赖后运行gradio_app.py记得带--low_vram_mode用仓库自带的assets/demo.png生成你的第一个 3D 模型——跑通之后再按第五节挑适合你场景的姿势深入。【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考