Hunyuan3D-2如何用图生3D：28秒出一个3D资产
发布时间：2026/9/13 16:15:20 作者：尧图编辑部 阅读量：1,286
Hunyuan3D-2如何用图生3D28秒出一个3D资产【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2手上有三张产品照片现在想拿到一个能直接导进引擎的3D模型——这正是 Hunyuan3D-2 图生3D 做的事一张或多张图像进去带材质的3D资产出来。本文面向需要批量产出3D资产、习惯写Python的工程师。 最小可运行路径安装后跑通第一次图生3D先克隆仓库并安装依赖PyTorch 需按官方指引单独安装git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 cd Hunyuan3D-2 pip install -r requirements.txt pip install -e .下面这段代码加载 0.6B 的 mini Turbo 模型对单张图做 5 步推理导出 turbo_result.glbimport torch from PIL import Image from hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline pipeline Hunyuan3DDiTFlowMatchingPipeline.from_pretrained( tencent/Hunyuan3D-2mini, subfolderhunyuan3d-dit-v2-mini-turbo, use_safetensorsFalse, devicecuda ) pipeline.enable_flashvdm(topk_modemerge) image Image.open(assets/demo.png).convert(RGBA) mesh pipeline( imageimage, num_inference_steps5, octree_resolution380, num_chunks20000, generatortorch.manual_seed(12345), output_typetrimesh )[0] mesh.export(turbo_result.glb)注意如果之后要跑纹理生成需要先用python setup.py install分别编译 hy3dgen/texgen/custom_rasterizer 与 hy3dgen/texgen/differentiable_renderer纹理管线依赖这两个光栅化组件。 它是怎么工作的图进去裸网格出来再贴材质Hunyuan3D-2 把图生3D拆成两段先用 Hunyuan3D-DiT流式扩散 Transformer把 13 张图变成无纹理网格再用 Hunyuan3D-Paint 结合输入图像给网格贴出 4K PBR 贴图。两段解耦意味着你也可以只对手绘网格跑贴图、或跳过第二段只留几何。FlashVDM 把 50 步推理蒸馏到 5 步这是28 秒的数字依据。各模块的内部结构见 shapegen 模块 与 texgen 模块这一节只给你一张地图不替代官方文档。 三个场景配方最快出图、最高质量、显存受限场景一最快出图5步推理28秒拿几何你要做什么验证单张参考图1 分钟内拿到一个能看的几何体用于概念确认。关键参数Turbo 模型、num_inference_steps5、octree_resolution380、num_chunks20000、FlashVDM 用 merge 模式。下面这段代码对仓库自带示例图做单图 5 步推理并导出 glbfrom hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline pipeline Hunyuan3DDiTFlowMatchingPipeline.from_pretrained( tencent/Hunyuan3D-2mini, subfolderhunyuan3d-dit-v2-mini-turbo) pipeline.enable_flashvdm(topk_modemerge) mesh pipeline(imageassets/demo.png, num_inference_steps5, octree_resolution380, num_chunks20000)[0] mesh.export(fast.glb)预期效果单网格约 28 秒6GB 显存即可跑几何完整可用边缘细节略逊于高步数版本。场景二最高质量多视图50步加4K贴图你要做什么产品或角色资产背面细节不能缺失且要带 PBR 材质导出。关键参数front/left/back 三视图输入至少 3 个视角num_inference_steps50换 30 步可再提速octree_resolution380成品再挂 Hunyuan3D-Paint 出 4K PBR 贴图。三视图建网格并一次性贴好贴图的完整流程import torch from PIL import Image from hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline from hy3dgen.texgen import Hunyuan3DPaintPipeline images {k: Image.open(fassets/example_mv_images/1/{k}.png).convert(RGBA) for k in (front, left, back)} pipeline Hunyuan3DDiTFlowMatchingPipeline.from_pretrained( tencent/Hunyuan3D-2mv, subfolderhunyuan3d-dit-v2-mv, variantfp16) mesh pipeline(imageimages, num_inference_steps50, octree_resolution380, num_chunks20000, generatortorch.manual_seed(12345))[0] paint Hunyuan3DPaintPipeline.from_pretrained(tencent/Hunyuan3D-2) mesh paint(mesh, imagelist(images.values())) mesh.export(demo_mv.glb)预期效果标准 50 步约 2 分 47 秒/模型输出的 glb 带 4K PBR 贴图单视图拍不到的背面细节也能补全。场景三显存受限8GB卡跑完全流程你要做什么显卡显存不超过 8GB也要把形状生成和纹理生成都跑下来。关键参数low_vram_modeTrue低显存模式、load_in_4bitTrue4bit 量化加载、device_mapauto自动分配设备。低显存加载配置如下跑法与前两段完全相同pipeline Hunyuan3DDiTFlowMatchingPipeline.from_pretrained( tencent/Hunyuan3D-2mini, device_mapauto, load_in_4bitTrue, low_vram_modeTrue )不写代码的话官方 Gradio 界面自带低显存参数python gradio_app.py --model_path tencent/Hunyuan3D-2mini --subfolder hunyuan3d-dit-v2-mini-turbo --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode --enable_flashvdm预期效果仅形状生成约 6GB 显存形状加纹理全流程约 16GB4bit 加低显存模式后 8GB 卡也能跑完全流程代价是推理耗时变长。 调参与排错3个高频问题参数基线与官方示例一致参数作用推荐值num_inference_steps推理步数Turbo 5-8高质量 30-50octree_resolution体素分辨率380-420越高细节越细num_chunks并行块数20000-40000随显存调现象 → 可能原因 → 调整项现象可能原因调整项网格边缘锯齿明显octree_resolution 过低提到 420步数加到 8多视图拼接处有裂缝输入图光照不一致背景移除预处理统一背景纹理细节不足未启用纹理阶段挂上 Paint 贴图管线显存溢出 OOM分辨率与步数过高4bit 低显存模式 按需求选配置按时间预算和显存挑档位场景推荐配置显存耗时质量快速原型Turbo 5步6GB28秒中高平衡质量标准 20步8GB1分15秒高影视级多视图 50步 贴图16GB3分40秒影视级与现有方案的性能对照模型推理时间多视图支持纹理质量传统开源方案3-5分钟有限基础闭源商业方案1-2分钟支持优秀Hunyuan3D-2标准2分47秒支持优秀Hunyuan3D-2 Turbo28秒支持优秀延伸与参考官方文档安装说明、代码使用、Gradio 使用、API Server、Blender 插件、ComfyUI 集成核心模块形状生成模块、纹理生成模块、示例脚本目录、技术报告Blender 插件入口blender_addon.py配合本地 API server 使用API serverpython api_server.py --host 0.0.0.0 --port 8080POST 图片即可取回 glb社区项目ComfyUI-3D-Pack、ComfyUI-Hunyuan3DWrapper、Hunyuan3D-2-WinPortableWindows 一键安装、Hunyuan3D-2GPColab 优化版建议的顺序先跑一遍 faster_shape_gen_with_flashvdm_mini_turbo.py 拿到第一个 glb再把自己的三视图产品照换进去验证多视图配方最后接上贴图管线出带 4K PBR 的完整资产。需要批量生产时直接切到 api_server.py把图片 POST 给它即可。【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
尧图网站开发 