5 分钟把图片变成 3D 资产Hunyuan3D-2 图生 3D 与纹理合成完整实操指南【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2发一张照片它能还你一个带材质的完整 3D 模型——这就是腾讯混元团队开源的 Hunyuan3D-2 做的事。它把造形状和上颜色拆成两步先用 Hunyuan3D-DiT 生成几何体再用 Hunyuan3D-Paint 给几何体合成高分辨率纹理最后输出一个.glb文件3D 领域的通用文件格式游戏引擎、网页、建模软件都能直接打开。哪怕你从没接触过建模也完全可以在自己的电脑上跑通第一个版本。它到底能帮你干什么从一张图到成品 3D 资产一句话定位Hunyuan3D-2 是一个图生 3D 纹理合成的两阶段生成系统输入一张或多张图片输出带 PBR 材质一套让物体看起来像木头、金属、布料的贴图集合的高分辨率 3D 资产。下面这张表能帮你建立预期对比项常规手工建模用 Hunyuan3D-2拿到第一个可用资产数小时到数天且依赖软件熟练度单图生成分钟级首次需下载模型权重纹理与材质手工绘制需要学贴图工具Paint 模型自动合成高分辨率纹理改主意了怎么办改网格、重刷材质换一张图重新生成输入门槛需要 Blender 级别技能几行 Python或浏览器里点几下输入形式无单张图或同一物体的正面/侧面/背面多张图先选路线要快、要精还是省显存动手装环境之前先按你的目标定路线后面所有配置都围绕它展开⚡要快→ 选Hunyuan3D-2mini的 Turbo 版0.6B 小模型 FlashVDM 加速FlashVDM 是一种把去噪步数从几十步压到 5 步的技术。单图输入约 6GB 显存适合一次试很多个创意。要精→ 选标准版Hunyuan3D-21.1B推理步数给到 30~50 步、网格分辨率 380 以上如果单个视角表达不清比如背面细节换多视图模型Hunyuan3D-2mv喂正面/左侧/背面三张图。省显存→ 任意模型都配low_vram_mode低显存模式Gradio 界面加--low_vram_mode参数即可显存紧张就先用 mini 系列跑形状纹理阶段单独再跑。开工前的三件准备硬件一块 NVIDIA GPU也支持 macOS / Windows / Linux。为什么扩散模型的主计算在 GPU 上。显存只生成形状约 6GB形状 纹理一起跑建议 16GB。为什么官方给出的两阶段总占用就是 16GB 级别。软件Python PyTorch按你的 GPU 去 PyTorch 官网装对应版本。为什么整个系统跑在 PyTorch 上。依赖与本体pip install -r requirements.txt然后pip install -e .。为什么前者装第三方库后者把hy3dgen包注册进环境。两个 C/CUDA 扩展custom_rasterizer和differentiable_renderer各自python setup.py install。为什么纹理合成阶段要靠它们做光栅化和贴图烘焙只玩形状生成可以跳过。模型权重形状模型三选一tencent/Hunyuan3D-21.1B 标准、tencent/Hunyuan3D-2mini0.6B 轻量、tencent/Hunyuan3D-2mv1.1B 多视图。纹理模型Hunyuan3D-Paint1.3B。首次运行时按你代码里写的名字自动下载、缓存在本地只下一次。注意仓库采用混元社区许可商用前建议读一遍许可条款。5 步出第一个模型先做克隆再做安装最后跑一个最小示例。第一步克隆仓库git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 cd Hunyuan3D-2第二步装依赖PyTorch 已按上面装好pip install -r requirements.txt pip install -e .第三步新建一个first_model.py只写这几行——加载形状生成管线喂仓库自带的演示图导出结果from hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline pipeline Hunyuan3DDiTFlowMatchingPipeline.from_pretrained( tencent/Hunyuan3D-2mini, subfolderhunyuan3d-dit-v2-mini ) mesh pipeline(imageassets/demo.png)[0] mesh.export(first.glb)第四步python first_model.py。首次运行会先下载权重随后进入生成等进度条走完。第五步用任意 3D 查看器或 Blender打开first.glb。你看到的应该是一个没有颜色的白模网格——网格就是组成 3D 模型的三角面片集合这一步只负责形色放到下一节加。不想写代码的话直接起一个网页版也行装好依赖后运行python3 gradio_app.py --model_path tencent/Hunyuan3D-2mini --subfolder hunyuan3d-dit-v2-mini --low_vram_mode想要什么效果就改哪个参数形状是 Hunyuan3D-DiT 生成的纹理是 Hunyuan3D-Paint 合成的两个阶段各有各的旋钮。先看整体流程形状满意之后加两行代码就能补上颜色得到下面这种带完整材质的成品from hy3dgen.texgen import Hunyuan3DPaintPipeline paint Hunyuan3DPaintPipeline.from_pretrained(tencent/Hunyuan3D-2) mesh paint(mesh, imageassets/demo.png) mesh.export(first_textured.glb)关键参数不用背全记住想要什么 → 改哪里 → 代价就够了你想要改哪里大致代价边缘更锐利、细节更多octree_resolution从 380 提到 420它是网格的精度档位类似模型的像素数显存上升、生成变慢形状更稳、少破面num_inference_steps从 30 提到 50耗时大约翻倍出图快几倍换 Turbo 子文件夹 pipeline.enable_flashvdm(topk_modemerge)步数给 5精细处略有损失补全照片里看不到的背面换Hunyuan3D-2mv传入 front/left/back 三张图需要三张同物体图显存更高大网格处理更快num_chunks从 20000 提到 40000网格提取的批处理大小显存上升examples/ 目录里每个脚本对应一种场景拿不准就看哪个文件名像你的需求文档在 docs/。翻车了怎么办三个高频问题的排查现象 1报 CUDA out of memory显存不足。大概率原因显存在 8GB 左右却同时跑形状 纹理或octree_resolution给太高。 处理办法加--low_vram_mode低显存模式换 0.6B 的 mini 模型把分辨率降回 380或者形状、纹理分两个进程跑中间存一次.glb。现象 2模型上飘着一层背景板。大概率原因输入图没去背景模型把背景当成物体的一部分立了起来。 处理办法生成前过一遍仓库自带的BackgroundRemover见 hy3dgen/rembg.py或直接使用透明底PNG图片。现象 3耳朵、绳带、小饰物这类细处缺失或发糊。大概率原因推理步数不够或octree_resolution偏低。 处理办法步数提到 50、分辨率提到 420 再试同时确认输入图本身清晰度够建议 1024 以上。现象 4多视图场景三张图拼接处有裂缝或错位。大概率原因三个视角的光照、背景差别太大模型对不齐。 处理办法三张图在相同光照下渲染或拍摄统一做背景移除后再输入。命令行之外插件、API 与社区项目gradio_app.py浏览器界面上传图片即出 3D。适合不想写代码、只想出活的人。api_server.py本地起 HTTP 服务--host 0.0.0.0 --port 8080支持图生 3D、给已有网格补纹理等接口。适合要把生成能力接进自己应用或批量处理的人。blender_addon.pyBlender 插件配合 API 服务在 Blender 里直接触发生成。适合本来就住在 Blender 里的建模师。examples/11 个可直接运行的示例覆盖单图、多视图、Turbo 加速、纹理合成等。适合照着改参数做实验的人。hy3dgen/shapegen/形状生成核心源码DiT、VAE、网格后处理。适合想搞懂原理的人。hy3dgen/texgen/纹理合成核心源码可微渲染、光栅器、Paint 管线。适合想改纹理逻辑的人。社区方向上也有不少现成轮子ComfyUI-3D-Pack 和 ComfyUI-Hunyuan3DWrapper 把它接进了 ComfyUI 的节点式工作流适合喜欢可视化搭流程的人Hunyuan3D-2-WinPortable 是 Windows 整合包适合不想折腾环境的人Hunyuan3D-2GP 提供了 Colab 环境适合本地没有 GPU 的人。接下来先跑这几个示例按这个顺序走每一步都比上一步多一个能力examples/shape_gen_mini.py—— 用轻量模型出第一个白模确认环境没问题。examples/textured_shape_gen_mini.py—— 同一个模型加上纹理阶段看上色前后的差别。examples/shape_gen_multiview.py—— 换成 front/left/back 三视图输入体会多视图融合解决遮挡的效果。examples/faster_shape_gen_with_flashvdm_mini_turbo.py—— 切到 Turbo 5 步推理感受速度差异。跑完这四条你手里会有白模、彩模、多视图模型各一个也顺手摸清了步数、分辨率、加速三个旋钮各自的手感。后面如果要给自制网格补纹理、或者接入 Gradio / API / Blender就按上一节的路径直接取用即可。【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 5 分钟把图片变成 3D 资产：Hunyuan3D-2 图生 3D 与纹理合成完整实操指南
5 分钟把图片变成 3D 资产Hunyuan3D-2 图生 3D 与纹理合成完整实操指南【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2发一张照片它能还你一个带材质的完整 3D 模型——这就是腾讯混元团队开源的 Hunyuan3D-2 做的事。它把造形状和上颜色拆成两步先用 Hunyuan3D-DiT 生成几何体再用 Hunyuan3D-Paint 给几何体合成高分辨率纹理最后输出一个.glb文件3D 领域的通用文件格式游戏引擎、网页、建模软件都能直接打开。哪怕你从没接触过建模也完全可以在自己的电脑上跑通第一个版本。它到底能帮你干什么从一张图到成品 3D 资产一句话定位Hunyuan3D-2 是一个图生 3D 纹理合成的两阶段生成系统输入一张或多张图片输出带 PBR 材质一套让物体看起来像木头、金属、布料的贴图集合的高分辨率 3D 资产。下面这张表能帮你建立预期对比项常规手工建模用 Hunyuan3D-2拿到第一个可用资产数小时到数天且依赖软件熟练度单图生成分钟级首次需下载模型权重纹理与材质手工绘制需要学贴图工具Paint 模型自动合成高分辨率纹理改主意了怎么办改网格、重刷材质换一张图重新生成输入门槛需要 Blender 级别技能几行 Python或浏览器里点几下输入形式无单张图或同一物体的正面/侧面/背面多张图先选路线要快、要精还是省显存动手装环境之前先按你的目标定路线后面所有配置都围绕它展开⚡要快→ 选Hunyuan3D-2mini的 Turbo 版0.6B 小模型 FlashVDM 加速FlashVDM 是一种把去噪步数从几十步压到 5 步的技术。单图输入约 6GB 显存适合一次试很多个创意。要精→ 选标准版Hunyuan3D-21.1B推理步数给到 30~50 步、网格分辨率 380 以上如果单个视角表达不清比如背面细节换多视图模型Hunyuan3D-2mv喂正面/左侧/背面三张图。省显存→ 任意模型都配low_vram_mode低显存模式Gradio 界面加--low_vram_mode参数即可显存紧张就先用 mini 系列跑形状纹理阶段单独再跑。开工前的三件准备硬件一块 NVIDIA GPU也支持 macOS / Windows / Linux。为什么扩散模型的主计算在 GPU 上。显存只生成形状约 6GB形状 纹理一起跑建议 16GB。为什么官方给出的两阶段总占用就是 16GB 级别。软件Python PyTorch按你的 GPU 去 PyTorch 官网装对应版本。为什么整个系统跑在 PyTorch 上。依赖与本体pip install -r requirements.txt然后pip install -e .。为什么前者装第三方库后者把hy3dgen包注册进环境。两个 C/CUDA 扩展custom_rasterizer和differentiable_renderer各自python setup.py install。为什么纹理合成阶段要靠它们做光栅化和贴图烘焙只玩形状生成可以跳过。模型权重形状模型三选一tencent/Hunyuan3D-21.1B 标准、tencent/Hunyuan3D-2mini0.6B 轻量、tencent/Hunyuan3D-2mv1.1B 多视图。纹理模型Hunyuan3D-Paint1.3B。首次运行时按你代码里写的名字自动下载、缓存在本地只下一次。注意仓库采用混元社区许可商用前建议读一遍许可条款。5 步出第一个模型先做克隆再做安装最后跑一个最小示例。第一步克隆仓库git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 cd Hunyuan3D-2第二步装依赖PyTorch 已按上面装好pip install -r requirements.txt pip install -e .第三步新建一个first_model.py只写这几行——加载形状生成管线喂仓库自带的演示图导出结果from hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline pipeline Hunyuan3DDiTFlowMatchingPipeline.from_pretrained( tencent/Hunyuan3D-2mini, subfolderhunyuan3d-dit-v2-mini ) mesh pipeline(imageassets/demo.png)[0] mesh.export(first.glb)第四步python first_model.py。首次运行会先下载权重随后进入生成等进度条走完。第五步用任意 3D 查看器或 Blender打开first.glb。你看到的应该是一个没有颜色的白模网格——网格就是组成 3D 模型的三角面片集合这一步只负责形色放到下一节加。不想写代码的话直接起一个网页版也行装好依赖后运行python3 gradio_app.py --model_path tencent/Hunyuan3D-2mini --subfolder hunyuan3d-dit-v2-mini --low_vram_mode想要什么效果就改哪个参数形状是 Hunyuan3D-DiT 生成的纹理是 Hunyuan3D-Paint 合成的两个阶段各有各的旋钮。先看整体流程形状满意之后加两行代码就能补上颜色得到下面这种带完整材质的成品from hy3dgen.texgen import Hunyuan3DPaintPipeline paint Hunyuan3DPaintPipeline.from_pretrained(tencent/Hunyuan3D-2) mesh paint(mesh, imageassets/demo.png) mesh.export(first_textured.glb)关键参数不用背全记住想要什么 → 改哪里 → 代价就够了你想要改哪里大致代价边缘更锐利、细节更多octree_resolution从 380 提到 420它是网格的精度档位类似模型的像素数显存上升、生成变慢形状更稳、少破面num_inference_steps从 30 提到 50耗时大约翻倍出图快几倍换 Turbo 子文件夹 pipeline.enable_flashvdm(topk_modemerge)步数给 5精细处略有损失补全照片里看不到的背面换Hunyuan3D-2mv传入 front/left/back 三张图需要三张同物体图显存更高大网格处理更快num_chunks从 20000 提到 40000网格提取的批处理大小显存上升examples/ 目录里每个脚本对应一种场景拿不准就看哪个文件名像你的需求文档在 docs/。翻车了怎么办三个高频问题的排查现象 1报 CUDA out of memory显存不足。大概率原因显存在 8GB 左右却同时跑形状 纹理或octree_resolution给太高。 处理办法加--low_vram_mode低显存模式换 0.6B 的 mini 模型把分辨率降回 380或者形状、纹理分两个进程跑中间存一次.glb。现象 2模型上飘着一层背景板。大概率原因输入图没去背景模型把背景当成物体的一部分立了起来。 处理办法生成前过一遍仓库自带的BackgroundRemover见 hy3dgen/rembg.py或直接使用透明底PNG图片。现象 3耳朵、绳带、小饰物这类细处缺失或发糊。大概率原因推理步数不够或octree_resolution偏低。 处理办法步数提到 50、分辨率提到 420 再试同时确认输入图本身清晰度够建议 1024 以上。现象 4多视图场景三张图拼接处有裂缝或错位。大概率原因三个视角的光照、背景差别太大模型对不齐。 处理办法三张图在相同光照下渲染或拍摄统一做背景移除后再输入。命令行之外插件、API 与社区项目gradio_app.py浏览器界面上传图片即出 3D。适合不想写代码、只想出活的人。api_server.py本地起 HTTP 服务--host 0.0.0.0 --port 8080支持图生 3D、给已有网格补纹理等接口。适合要把生成能力接进自己应用或批量处理的人。blender_addon.pyBlender 插件配合 API 服务在 Blender 里直接触发生成。适合本来就住在 Blender 里的建模师。examples/11 个可直接运行的示例覆盖单图、多视图、Turbo 加速、纹理合成等。适合照着改参数做实验的人。hy3dgen/shapegen/形状生成核心源码DiT、VAE、网格后处理。适合想搞懂原理的人。hy3dgen/texgen/纹理合成核心源码可微渲染、光栅器、Paint 管线。适合想改纹理逻辑的人。社区方向上也有不少现成轮子ComfyUI-3D-Pack 和 ComfyUI-Hunyuan3DWrapper 把它接进了 ComfyUI 的节点式工作流适合喜欢可视化搭流程的人Hunyuan3D-2-WinPortable 是 Windows 整合包适合不想折腾环境的人Hunyuan3D-2GP 提供了 Colab 环境适合本地没有 GPU 的人。接下来先跑这几个示例按这个顺序走每一步都比上一步多一个能力examples/shape_gen_mini.py—— 用轻量模型出第一个白模确认环境没问题。examples/textured_shape_gen_mini.py—— 同一个模型加上纹理阶段看上色前后的差别。examples/shape_gen_multiview.py—— 换成 front/left/back 三视图输入体会多视图融合解决遮挡的效果。examples/faster_shape_gen_with_flashvdm_mini_turbo.py—— 切到 Turbo 5 步推理感受速度差异。跑完这四条你手里会有白模、彩模、多视图模型各一个也顺手摸清了步数、分辨率、加速三个旋钮各自的手感。后面如果要给自制网格补纹理、或者接入 Gradio / API / Blender就按上一节的路径直接取用即可。【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考