Hunyuan3D-2 本地部署实操三步把一张图片变成带纹理的 3D 模型【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2想把客户发来的一张海豚图放进游戏场景传统建模要排一整周的期。Hunyuan3D-2 是腾讯开源的 3D 资产生成系统一张图片、甚至一段文字描述都能变成带纹理的高分辨率 3D 模型且全部计算跑在你自己的电脑上。读完本文你能在本地搭好运行环境、完成第一次图生 3D并把它接入 Blender 或自己的应用。01 先形状后纹理一条管线里的两个模型Hunyuan3D-2 把 3D 生成拆成两段第一段由 Hunyuan3D-DiT 负责它从输入条件里推断几何结构输出一张裸网格第二段交给 Hunyuan3D-Paint借助几何与扩散先验给这张网格铺上高分辨率贴图。拆开的好处是每一步只解决一件事而且 Paint 的纹理合成不挑来源——手工雕刻的网格同样能上色。技术细节可以看 技术报告 PDF各变体模型的规模与定位整理在 模型清单 里。显存方面纯形状生成约需 6GB形状加纹理全流程约需 16GB。也就是说中端卡跑几何没问题真正把显存吃满的是纹理环节。02 本地环境三步走克隆、依赖、两个 C 扩展动手前先对一遍环境要求Windows 10/11 64 位Linux、macOS 也可用、Python 3.10.x3.10.9 较稳、NVIDIA 显卡且显存 ≥6GB、16GB 内存。Windows 用户额外要装 Visual Studio 2022 的使用 C 的桌面开发workload——项目里有两个纹理相关的 C 扩展必须现场编译缺编译器时安装报错。1️⃣克隆代码并安装依赖国内网络慢可给 pip 加镜像源git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 cd Hunyuan3D-2 pip install -r requirements.txt pip install -e .2️⃣编译两个纹理扩展custom_rasterizer自定义光栅化器和 differentiable_renderer可微分渲染器各自目录里都有 setup.py按顺序执行即可cd hy3dgen/texgen/custom_rasterizer python setup.py install cd ../../.. cd hy3dgen/texgen/differentiable_renderer python setup.py install 编译时报cl.exe not found说明当前终端里没有编译器环境。关掉终端从开始菜单启动 VS2022 自带的 x64 Native Tools Command Prompt再重跑上面的命令。03 Gradio 界面的三种用法文字、单图、多视角对新手最友好的入口是 Gradio 网页界面。第一次跑建议从 0.6B 的轻量模型开始一条命令启动python3 gradio_app.py --model_path tencent/Hunyuan3D-2mini --subfolder hunyuan3d-dit-v2-mini --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode启动后浏览器自动弹出页面共三种输入方式文字描述输入一个黄色的香蕉带有自然纹理这类句子模型从文本直接推断形状单张图片上传一张照片即可。assets/example_images/ 里备了几十张现成的测试图比如这根香蕉多视角图片上传物体前、后、左几张不同角度的照片重建的几何更准。assets/example_mv_images/ 下有 14 组三视角样例其中一组的正面图想换主力 1.1B 模型把--model_path改成tencent/Hunyuan3D-2、--subfolder改成hunyuan3d-dit-v2-0追求速度就用 Turbo 蒸馏版--subfolder hunyuan3d-dit-v2-0-turbo并追加--enable_flashvdm。更多组合写法可以参考 examples 目录。拿项目自带的小海豚走一遍完整流程上传这张图后等 6-8 分钟输出是一个可任意角度旋转查看的 3D 模型海豚的体态和蓝色皮肤纹理都被保留下来。04 接入现有工作流Blender 插件与 API 服务两条路已经在 Blender3.0里干活的话直接装插件菜单编辑 偏好设置 插件点安装并选择项目根目录的 blender_addon.py启用后 3D 视图侧边栏会出现 Hunyuan3D-2 3D Generator 面板支持文字、图像输入与纹理生成产出直接落进当前场景。注意插件本身不跑模型它靠调用 API 服务所以得先把服务端拉起来。要把 3D 生成嵌进自研应用走 API 服务python api_server.py --host 0.0.0.0 --port 8080 --enable_tex起来之后发 POST 请求图片 base64 进、.glb 文件出img_b64_str$(base64 -i assets/example_images/example_002.png) curl -X POST http://localhost:8080/generate -H Content-Type: application/json \ -d {image: $img_b64_str} -o output.glb接口的更多字段说明见 API 文档。05 显存不够怎么配三档方案加参数参考按显卡档位挑一套启动参数高性能档RTX 4070 及以上--fp16开半精度显存大约省一半--flashvdm开 FlashVDM 加速速度快约三成--resolution 384出最终质量平衡档RTX 3060/3070--resolution 256 --steps 30标准质量速度质量都居中入门档GTX 1660/RTX 2060--model_path tencent/Hunyuan3D-2mini --resolution 128用轻量模型换跑得起来参数作用建议取值--octree_resolution八叉树分辨率几何细节的上限128-256--resolution模型分辨率决定整体精细度128-384--guidance_scale引导尺度越高越贴着输入走5.0-10.0--steps推理步数越多越细但越慢20-50 一个省算力的习惯先用 128 低分辨率快速预览形态满意了再上 256 以上重出成品避免反复烧显存。从克隆代码到第一次图生 3D再到接进 Blender 和自研服务这条链路到这里已经通了。现在就动手用第 03 节的 mini 模型命令启动 Gradio 界面丢进assets/example_images/里那张香蕉图5 分钟后你就能拿到自己生成的第一个带纹理 3D 模型。【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Hunyuan3D-2 本地部署实操：三步把一张图片变成带纹理的 3D 模型
Hunyuan3D-2 本地部署实操三步把一张图片变成带纹理的 3D 模型【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2想把客户发来的一张海豚图放进游戏场景传统建模要排一整周的期。Hunyuan3D-2 是腾讯开源的 3D 资产生成系统一张图片、甚至一段文字描述都能变成带纹理的高分辨率 3D 模型且全部计算跑在你自己的电脑上。读完本文你能在本地搭好运行环境、完成第一次图生 3D并把它接入 Blender 或自己的应用。01 先形状后纹理一条管线里的两个模型Hunyuan3D-2 把 3D 生成拆成两段第一段由 Hunyuan3D-DiT 负责它从输入条件里推断几何结构输出一张裸网格第二段交给 Hunyuan3D-Paint借助几何与扩散先验给这张网格铺上高分辨率贴图。拆开的好处是每一步只解决一件事而且 Paint 的纹理合成不挑来源——手工雕刻的网格同样能上色。技术细节可以看 技术报告 PDF各变体模型的规模与定位整理在 模型清单 里。显存方面纯形状生成约需 6GB形状加纹理全流程约需 16GB。也就是说中端卡跑几何没问题真正把显存吃满的是纹理环节。02 本地环境三步走克隆、依赖、两个 C 扩展动手前先对一遍环境要求Windows 10/11 64 位Linux、macOS 也可用、Python 3.10.x3.10.9 较稳、NVIDIA 显卡且显存 ≥6GB、16GB 内存。Windows 用户额外要装 Visual Studio 2022 的使用 C 的桌面开发workload——项目里有两个纹理相关的 C 扩展必须现场编译缺编译器时安装报错。1️⃣克隆代码并安装依赖国内网络慢可给 pip 加镜像源git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 cd Hunyuan3D-2 pip install -r requirements.txt pip install -e .2️⃣编译两个纹理扩展custom_rasterizer自定义光栅化器和 differentiable_renderer可微分渲染器各自目录里都有 setup.py按顺序执行即可cd hy3dgen/texgen/custom_rasterizer python setup.py install cd ../../.. cd hy3dgen/texgen/differentiable_renderer python setup.py install 编译时报cl.exe not found说明当前终端里没有编译器环境。关掉终端从开始菜单启动 VS2022 自带的 x64 Native Tools Command Prompt再重跑上面的命令。03 Gradio 界面的三种用法文字、单图、多视角对新手最友好的入口是 Gradio 网页界面。第一次跑建议从 0.6B 的轻量模型开始一条命令启动python3 gradio_app.py --model_path tencent/Hunyuan3D-2mini --subfolder hunyuan3d-dit-v2-mini --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode启动后浏览器自动弹出页面共三种输入方式文字描述输入一个黄色的香蕉带有自然纹理这类句子模型从文本直接推断形状单张图片上传一张照片即可。assets/example_images/ 里备了几十张现成的测试图比如这根香蕉多视角图片上传物体前、后、左几张不同角度的照片重建的几何更准。assets/example_mv_images/ 下有 14 组三视角样例其中一组的正面图想换主力 1.1B 模型把--model_path改成tencent/Hunyuan3D-2、--subfolder改成hunyuan3d-dit-v2-0追求速度就用 Turbo 蒸馏版--subfolder hunyuan3d-dit-v2-0-turbo并追加--enable_flashvdm。更多组合写法可以参考 examples 目录。拿项目自带的小海豚走一遍完整流程上传这张图后等 6-8 分钟输出是一个可任意角度旋转查看的 3D 模型海豚的体态和蓝色皮肤纹理都被保留下来。04 接入现有工作流Blender 插件与 API 服务两条路已经在 Blender3.0里干活的话直接装插件菜单编辑 偏好设置 插件点安装并选择项目根目录的 blender_addon.py启用后 3D 视图侧边栏会出现 Hunyuan3D-2 3D Generator 面板支持文字、图像输入与纹理生成产出直接落进当前场景。注意插件本身不跑模型它靠调用 API 服务所以得先把服务端拉起来。要把 3D 生成嵌进自研应用走 API 服务python api_server.py --host 0.0.0.0 --port 8080 --enable_tex起来之后发 POST 请求图片 base64 进、.glb 文件出img_b64_str$(base64 -i assets/example_images/example_002.png) curl -X POST http://localhost:8080/generate -H Content-Type: application/json \ -d {image: $img_b64_str} -o output.glb接口的更多字段说明见 API 文档。05 显存不够怎么配三档方案加参数参考按显卡档位挑一套启动参数高性能档RTX 4070 及以上--fp16开半精度显存大约省一半--flashvdm开 FlashVDM 加速速度快约三成--resolution 384出最终质量平衡档RTX 3060/3070--resolution 256 --steps 30标准质量速度质量都居中入门档GTX 1660/RTX 2060--model_path tencent/Hunyuan3D-2mini --resolution 128用轻量模型换跑得起来参数作用建议取值--octree_resolution八叉树分辨率几何细节的上限128-256--resolution模型分辨率决定整体精细度128-384--guidance_scale引导尺度越高越贴着输入走5.0-10.0--steps推理步数越多越细但越慢20-50 一个省算力的习惯先用 128 低分辨率快速预览形态满意了再上 256 以上重出成品避免反复烧显存。从克隆代码到第一次图生 3D再到接进 Blender 和自研服务这条链路到这里已经通了。现在就动手用第 03 节的 mini 模型命令启动 Gradio 界面丢进assets/example_images/里那张香蕉图5 分钟后你就能拿到自己生成的第一个带纹理 3D 模型。【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考