Hunyuan3D-2本地部署全解从一张图到带纹理3D模型只需3条命令【免费下载链接】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模型出本节说清它能帮你做什么方便你判断是否匹配手头的活。Hunyuan3D-2 把生成拆成两段形状模型 Hunyuan3D-DiT 负责图生3D几何纹理模型 Hunyuan3D-Paint 负责给网格上色输入一张图输出可直接进引擎的 GLB 文件。除了单图转3D它还支持文本生成、多视角图片融合以及给你现有的手工网格单独生成纹理。 环境检查与安装把依赖和编译一次做对本节解决装环境时最容易卡住的两个点显存规划和纹理模块的C编译。先对照硬件与软件要求系统Windows / macOS / LinuxCUDA显卡效果最好显存纯形状生成约 6GB形状纹理全流程约 16GBPython 3.10 左右PyTorch 需先按官网版本装好磁盘预留 20GB 以上权重首次启动自动下载克隆仓库并安装依赖git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 cd Hunyuan3D-2 pip install -r requirements.txt pip install -e .预期输出终端无 ERROR末尾打印 Successfully installed 列表。纹理流程还需要编译两个C扩展这一步比较坑只跑形状生成可以跳过cd hy3dgen/texgen/custom_rasterizer python3 setup.py install cd ../../.. cd hy3dgen/texgen/differentiable_renderer python3 setup.py install预期输出两个扩展依次构建并安装完成Windows 下要放在 VS2022 的 x64 Native Tools 命令行里执行。 最短路径跑通Gradio一条命令出结果本节给你从 0 到看到第一个生成结果的最少操作只有下面这一条命令。纹理默认开启显存够就直接出带贴图的模型python3 gradio_app.py --model_path tencent/Hunyuan3D-2 --subfolder hunyuan3d-dit-v2-0 --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode预期输出终端打印本地访问地址默认端口 8080浏览器自动打开 Gradio 页面首次运行会先下载模型权重别急。打开页面后上传图片并点击生成几分钟后拿到一个 glb先出白模再刷上纹理。下图是同一流程只出形状、不刷纹理时的效果大理石质感的光头就是形状模型本身的产出水平️ 场景化深度用法试玩、接入应用、进Blender本节按使用场景拆开讲每个场景给一个具体输入示例和对应的启动命令。Gradio界面快速试玩图生3D与文本生成启动命令沿用上一节参数按需求微调。显存紧张时把模型换成 mini 加速组合--model_path tencent/Hunyuan3D-2mini --subfolder hunyuan3d-dit-v2-mini-turbo --enable_flashvdm想让纯文字也能生成3D启动时追加--enable_t23d然后在文本页签输入描述比如一座蓝色屋顶的卡通风格小房子不想要纹理就加--disable_tex。输入示例直接用仓库自带的assets/demo.png预期产出是一个可下载的 glb页面里能直接旋转预览。文本模式生成的角色类资产长这样服装和材质细节都带着API服务接入自有应用POST一张图拿回GLB想把自己的网站或管线挂上3D生成能力就启动 API 服务。它默认不带纹理用--enable_tex打开python api_server.py --host 0.0.0.0 --port 8080 --enable_tex预期输出uvicorn 启动提示监听 8080 端口。接着向/generate端点 POST 一张 base64 编码的图片响应体就是 GLB 文件img_b64_str$(base64 -i assets/demo.png) curl -X POST http://localhost:8080/generate -H Content-Type: application/json \ -d {image: $img_b64_str} -o output.glb预期输出本地生成 output.glb丢进任意 GLB 查看器即可打开。请求体里不传image改传text服务会先生成配图再做3D传mesh字段则跳过形状生成直接给已有网格上纹理。octree_resolution、num_inference_steps、guidance_scale都能从 JSON 透传。多视角输入适合需要背面细节的资产启动时把形状模型换成--model_path tencent/Hunyuan3D-2mv --subfolder hunyuan3d-dit-v2-mv按前、左、后三张视图投喂融合出更完整的结构完整流程参考 examples/fast_texture_gen_multiview.py。输入效果参考下图这类角色正视图Blender工具链集成模型直接进当前场景如果你日常工作在 Blender 里就把 Hunyuan3D-2 挂进现有工具链先确保 API 服务在跑命令同上一节再在 Blender 的 编辑 偏好设置 插件 里点安装选择仓库根目录的blender_addon.py启用后即可用文本或图片直接生成模型产出直接进当前场景接着细化编辑不用来回导文件。️ 调优与关键参数记住这几个就够本节列出手感最明显、值得记住的参数都出现在启动命令或 API 请求体里。显存推荐组合关键参数说明6GB2mini turbo--enable_flashvdm跑形状生成16GB完整版模型--low_vram_mode形状纹理全流程偏低任意模型--disable_tex关纹理省显存--subfolder选形状模型变体普通版、turbo步数更少、fast引导减半三档如hunyuan3d-dit-v2-0-turbo--enable_flashvdm开启 FlashVDM 加速推理和 turbo 变体搭配效果最好octree_resolution形状的八叉树分辨率API 默认 128越高越精细显存占用同步上涨num_inference_steps去噪步数API 默认 5官方示例用到 50步数越多越贴输入但越慢guidance_scale引导强度默认 5.0越高越贴近输入图但多样性下降 踩坑速查现象、原因、解法本节收集四个高频坑按现象对照排查现象原因解法全流程报 CUDA 显存不足纹理阶段吃显存16GB 起步换 2mini 或关纹理texgen 报模块未找到C 扩展未编译按安装节编译两个 setup.pyWindows 编译提示 cl.exe 缺失未加载 MSVC 环境用 VS2022 构建命令行执行API 返回 404 且 error_code1输入缺失或显存爆掉检查 image/text 字段调低分辨率 延伸资源文档、示例与技术报告本节给你三个深入入口按需取用。官方文档安装、Gradio、API、Blender 教程docs/source/started/index.md高级示例多视角、快速纹理、FlashVDMexamples/技术报告架构与评测细节assets/report/Tencent_Hunyuan3D_2_0.pdf模型权重首次运行时自动下载保持联网即可开始生成。【免费下载链接】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模型只需3条命令
Hunyuan3D-2本地部署全解从一张图到带纹理3D模型只需3条命令【免费下载链接】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模型出本节说清它能帮你做什么方便你判断是否匹配手头的活。Hunyuan3D-2 把生成拆成两段形状模型 Hunyuan3D-DiT 负责图生3D几何纹理模型 Hunyuan3D-Paint 负责给网格上色输入一张图输出可直接进引擎的 GLB 文件。除了单图转3D它还支持文本生成、多视角图片融合以及给你现有的手工网格单独生成纹理。 环境检查与安装把依赖和编译一次做对本节解决装环境时最容易卡住的两个点显存规划和纹理模块的C编译。先对照硬件与软件要求系统Windows / macOS / LinuxCUDA显卡效果最好显存纯形状生成约 6GB形状纹理全流程约 16GBPython 3.10 左右PyTorch 需先按官网版本装好磁盘预留 20GB 以上权重首次启动自动下载克隆仓库并安装依赖git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 cd Hunyuan3D-2 pip install -r requirements.txt pip install -e .预期输出终端无 ERROR末尾打印 Successfully installed 列表。纹理流程还需要编译两个C扩展这一步比较坑只跑形状生成可以跳过cd hy3dgen/texgen/custom_rasterizer python3 setup.py install cd ../../.. cd hy3dgen/texgen/differentiable_renderer python3 setup.py install预期输出两个扩展依次构建并安装完成Windows 下要放在 VS2022 的 x64 Native Tools 命令行里执行。 最短路径跑通Gradio一条命令出结果本节给你从 0 到看到第一个生成结果的最少操作只有下面这一条命令。纹理默认开启显存够就直接出带贴图的模型python3 gradio_app.py --model_path tencent/Hunyuan3D-2 --subfolder hunyuan3d-dit-v2-0 --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode预期输出终端打印本地访问地址默认端口 8080浏览器自动打开 Gradio 页面首次运行会先下载模型权重别急。打开页面后上传图片并点击生成几分钟后拿到一个 glb先出白模再刷上纹理。下图是同一流程只出形状、不刷纹理时的效果大理石质感的光头就是形状模型本身的产出水平️ 场景化深度用法试玩、接入应用、进Blender本节按使用场景拆开讲每个场景给一个具体输入示例和对应的启动命令。Gradio界面快速试玩图生3D与文本生成启动命令沿用上一节参数按需求微调。显存紧张时把模型换成 mini 加速组合--model_path tencent/Hunyuan3D-2mini --subfolder hunyuan3d-dit-v2-mini-turbo --enable_flashvdm想让纯文字也能生成3D启动时追加--enable_t23d然后在文本页签输入描述比如一座蓝色屋顶的卡通风格小房子不想要纹理就加--disable_tex。输入示例直接用仓库自带的assets/demo.png预期产出是一个可下载的 glb页面里能直接旋转预览。文本模式生成的角色类资产长这样服装和材质细节都带着API服务接入自有应用POST一张图拿回GLB想把自己的网站或管线挂上3D生成能力就启动 API 服务。它默认不带纹理用--enable_tex打开python api_server.py --host 0.0.0.0 --port 8080 --enable_tex预期输出uvicorn 启动提示监听 8080 端口。接着向/generate端点 POST 一张 base64 编码的图片响应体就是 GLB 文件img_b64_str$(base64 -i assets/demo.png) curl -X POST http://localhost:8080/generate -H Content-Type: application/json \ -d {image: $img_b64_str} -o output.glb预期输出本地生成 output.glb丢进任意 GLB 查看器即可打开。请求体里不传image改传text服务会先生成配图再做3D传mesh字段则跳过形状生成直接给已有网格上纹理。octree_resolution、num_inference_steps、guidance_scale都能从 JSON 透传。多视角输入适合需要背面细节的资产启动时把形状模型换成--model_path tencent/Hunyuan3D-2mv --subfolder hunyuan3d-dit-v2-mv按前、左、后三张视图投喂融合出更完整的结构完整流程参考 examples/fast_texture_gen_multiview.py。输入效果参考下图这类角色正视图Blender工具链集成模型直接进当前场景如果你日常工作在 Blender 里就把 Hunyuan3D-2 挂进现有工具链先确保 API 服务在跑命令同上一节再在 Blender 的 编辑 偏好设置 插件 里点安装选择仓库根目录的blender_addon.py启用后即可用文本或图片直接生成模型产出直接进当前场景接着细化编辑不用来回导文件。️ 调优与关键参数记住这几个就够本节列出手感最明显、值得记住的参数都出现在启动命令或 API 请求体里。显存推荐组合关键参数说明6GB2mini turbo--enable_flashvdm跑形状生成16GB完整版模型--low_vram_mode形状纹理全流程偏低任意模型--disable_tex关纹理省显存--subfolder选形状模型变体普通版、turbo步数更少、fast引导减半三档如hunyuan3d-dit-v2-0-turbo--enable_flashvdm开启 FlashVDM 加速推理和 turbo 变体搭配效果最好octree_resolution形状的八叉树分辨率API 默认 128越高越精细显存占用同步上涨num_inference_steps去噪步数API 默认 5官方示例用到 50步数越多越贴输入但越慢guidance_scale引导强度默认 5.0越高越贴近输入图但多样性下降 踩坑速查现象、原因、解法本节收集四个高频坑按现象对照排查现象原因解法全流程报 CUDA 显存不足纹理阶段吃显存16GB 起步换 2mini 或关纹理texgen 报模块未找到C 扩展未编译按安装节编译两个 setup.pyWindows 编译提示 cl.exe 缺失未加载 MSVC 环境用 VS2022 构建命令行执行API 返回 404 且 error_code1输入缺失或显存爆掉检查 image/text 字段调低分辨率 延伸资源文档、示例与技术报告本节给你三个深入入口按需取用。官方文档安装、Gradio、API、Blender 教程docs/source/started/index.md高级示例多视角、快速纹理、FlashVDMexamples/技术报告架构与评测细节assets/report/Tencent_Hunyuan3D_2_0.pdf模型权重首次运行时自动下载保持联网即可开始生成。【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考