Hunyuan3D-2 快速上手Turbo加速与多视图生成的最小可行路径【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2手头只有一两张产品图却要交付一套完整 3D 道具Hunyuan3D-2 把图像转3D拆成了两步先用 Turbo 加速档跑几何再对网格上纹理只有多视角素材时则切到多视图生成管线。本文按装环境、调 5 步推理、组三视角输入、跑通几何到纹理全链路的顺序展开每一节都给出可直接抄的命令和代码并附上显存与模型的硬性门槛。项目速览先看两阶段管线怎么分工Hunyuan3D-2 是腾讯混元团队开源的高清 3D 资产生成系统核心逻辑是先几何、后纹理Hunyuan3D-DiT 基于流匹配扩散变换器从条件图像还原出无纹理网格Hunyuan3D-Paint 再往网格上合成 2K 分辨率的 PBR 贴图。几何与纹理解耦带来两个实际好处可以只跑几何快速验证素材也可以给手搓网格单独上材质不必从头生成。仓库里的模型按体量分档1.1B 主模型、0.6B 的 mini 版、1.1B 多视图专用版、1.3B 纹理模型。官方给出的硬件门槛是纯几何生成约 6 GB 显存几何加纹理全流程约 16 GB。维度标准档Turbo 蒸馏档DiT 推理步数50 步5 步几何模型主 / mini / 多视图1.1B / 0.6B / 1.1B1.1B / 0.6B / 1.1BVAE 解码器原版替换为 Turbo VAEFlashVDM 加速几何生成显存约 6 GB约 6 GB几何 纹理全流程显存约 16 GB约 16 GBTurbo 的提速点有两个DiT 去噪步数从 50 压到 5解码器换成 FlashVDM 加速版。具体原理和参数在下一节展开。5分钟跑起来4 条命令装完纹理模块要单独编译结论先说装环境最少 4 条命令只有要跑纹理环节才需要额外编译两个 CUDA 模块。git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 cd Hunyuan3D-2 pip install -r requirements.txt pip install -e .第二条是纹理生成专用的光栅化模块编译依赖 CUDA 工具链仓库根部的 requirements.txt 里已声明 ninja 和 pybind11cd hy3dgen/texgen/custom_rasterizer python3 setup.py install cd ../../..如果只用几何生成第二条命令可以整体跳过要跑 Hunyuan3DPaint 则两个都要装因为可微渲染环节还涉及 hy3dgen/texgen/differentiable_renderer/ 下的另一个组件。首次运行时模型权重会从 Hugging Face 自动下载仓库本身只带代码和示例素材本地不放权重文件。Turbo 加速深入5 步推理的参数调法Turbo 的提速来自两处叠加步骤蒸馏把 DiT 的去噪步数从 50 压到 5enable_flashvdm()把 VAE 换成 Turbo 版解码器并打开自适应稀疏采样避免体素数量随八叉树分辨率线性膨胀。注意两者要配套——蒸馏版 DiT 只负责前向采样解码器才是耗时大头只改步数不改解码器收益有限。最小可运行代码参考 examples/faster_shape_gen_with_flashvdm_mini_turbo.pyfrom PIL import Image import torch from hy3dgen.rembg import BackgroundRemover from hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline pipeline Hunyuan3DDiTFlowMatchingPipeline.from_pretrained( tencent/Hunyuan3D-2mini, subfolderhunyuan3d-dit-v2-mini-turbo, # Turbo 蒸馏权重必须配 5 步 devicecuda, ) pipeline.enable_flashvdm(topk_modemerge) # 换 Turbo 解码器merge 档精度略高 img Image.open(assets/demo.png).convert(RGBA) if img.mode RGB: # 带背景的图先抠图否则背景会生成进网格 img BackgroundRemover()(img) mesh pipeline( imageimg, num_inference_steps5, # 蒸馏模型只能跑 5 步多了反而劣化 octree_resolution380, # 八叉树分辨率细节上限同时正比于显存 num_chunks20000, # 解码分块大小显存吃紧时调小 generatortorch.manual_seed(12345), output_typetrimesh, )[0] mesh.export(demo.glb)output_typetrimesh保证返回 trimesh 对象mesh.export()之后可直接存 glb 或 obj。多视图生成三张图怎么传目录怎么摆多视图管线吃三张同一物体的照片官方示例按 front正、left左、back后组织assets/example_mv_images/1/ ├── front.png # 正视图 ├── left.png # 左视图 └── back.png # 后视图仓库自带 14 组示例见 assets/example_mv_images/。三张图建议 1024 分辨率上下、同一光照、先统一去背再打包成字典传入images {} for name, path in zip( (front, left, back), ( assets/example_mv_images/1/front.png, assets/example_mv_images/1/left.png, assets/example_mv_images/1/back.png, ), ): img Image.open(path).convert(RGBA) if img.mode RGB: img BackgroundRemover()(img) # 去背是几何质量的底线别省 images[name] img pipeline Hunyuan3DDiTFlowMatchingPipeline.from_pretrained( tencent/Hunyuan3D-2mv, subfolderhunyuan3d-dit-v2-mv, variantfp16, # 多视图模型是单图版的两倍体量fp16 省一半显存 ) mesh pipeline( imageimages, num_inference_steps50, octree_resolution380, num_chunks20000, generatortorch.manual_seed(12345), output_typetrimesh, )[0] mesh.export(demo_mv.glb)三张视角互补正好补掉单图模式最难处理的遮挡区。完整参考见 examples/shape_gen_multiview.py。 端到端案例三视角道具从几何到纹理结论一条链路走三件事——Turbo DiT 出网格、Paint 管线上色、导出带贴图的 GLB。仓库里的 assets/1.glb 可以直接拿来当测试资产。import trimesh from hy3dgen.texgen import Hunyuan3DPaintPipeline # 1) Turbo 出几何代码同上一节 mesh pipeline(imageimages, num_inference_steps5, octree_resolution380, output_typetrimesh)[0] # 2) 上纹理Paint 管线同样有蒸馏版权重 paint Hunyuan3DPaintPipeline.from_pretrained( tencent/Hunyuan3D-2, subfolderhunyuan3d-paint-v2-0-turbo, ) textured paint(mesh, imageimages) # 直接复用那三张参考图纹理与视角天然对齐 # 3) 导出 textured.export(final.glb)参考 examples/fast_texture_gen_multiview.py 的完整写法。全流程约 16 GB 显存16 GB 卡单卡可跑。质量上分两层看几何细节上限由 DiT 步数与octree_resolution决定表面材质细节由 Paint 管线的 2K 贴图决定——Turbo 档几何偶发的轻微锯齿通常会被贴图盖住肉眼观感比裸网格好不少。⚠️ 排坑指南四类高频问题一张表现象表现一句话处理曲面锯齿、细节缺失Turbo 5 步档高频出现octree_resolution提到 420num_chunks调小防显存爆视角接缝多视图网格在视角交界处不连续回头查三张图同机位拍摄、统一去背、光照一致CUDA OOM解码或上纹理阶段直接崩溃加载加variantfp16GUI 场景加--low_vram_mode首跑特别慢第二次推理明显变快首次含权重下载与编译属正常开销三档建议 延伸资源按场景选档位每档一句话速度优先Turbo 5 步单张参考图用于批量验证素材和快速出白模。均衡标准 DiT 跑 30~50 步不启用 FlashVDM精度与耗时折中。质量优先多视图模型 50 步 Paint 2K 纹理成品交付用单资产显存预算给到 16 GB。不想写脚本的话仓库自带两个工程入口python3 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起 HTTP 服务blender_addon.py 可以直接在 Blender 里调它。延伸入口代码用法docs/source/started/code.md模型清单与下载docs/source/modelzoo.md技术报告assets/report/社区入口README.md 底部的微信、Discord、X 二维码几何、纹理、三档模型、GUI 和 API 都在这一个仓库里齐了——装好环境跑通第一个 GLB剩下的按上面三档往深处走就行。【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考