一张图片生成可旋转 3D 模型:Hunyuan3D-2 本地部署与参数调优实操【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2手里只有一张产品照或一段文字描述,就想拿到能拖进 Blender、能在网页里转着看的 3D 模型?Hunyuan3D-2 把这事做成了本地就能跑的开源方案:图生 3D、文生 3D、多视角融合都支持,产出的 GLB 可以直接二次编辑。下文按先看效果 → 搭环境 → 跑通 → 调参数的顺序走一遍,命令均可直接复制。先看点效果:图生 3D 能到什么程度仓库自带一批真实产出,挑几张感受一下:官方展示图,卡通角色、静物、道具都能出。单图生成的话:输入assets/example_images/里任意一张参考图,出来的就是这种带贴图、能 360° 旋转的 GLB。文字生成同样可用,仓库里备好了提示词示例(assets/example_prompts.txt):本地部署:装 Python 依赖与编译两个渲染扩展环境要求压缩成一张表:项目要求系统Windows 10/11 64 位(Linux 也可跑)Python3.10.x显卡NVIDIA 独显,8GB 显存起步(跑 mini),12GB 以上更从容内存/磁盘16GB 内存,20GB 可用空间(首次要拉模型权重)拿到代码并装 Python 依赖:git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 cd Hunyuan3D-2 pip install -r requirements.txt依赖互相冲突的话,先python -m venv venv建个虚拟环境再装。纹理生成依赖两个 C/CUDA 扩展,需要手动编译——它们负责把 3D 表面画成图、再反推 UV 贴图:cd hy3dgen/texgen/custom_rasterizer python setup.py install cd ../../.. cd hy3dgen/texgen/differentiable_renderer python setup.py install cd ../../..报cl.exe not found说明不在正确的编译环境里:用 Visual Studio 2022 的 x64 Native Tools Command Prompt 打开终端重跑上面两条即可,前提是装 VS 时勾选了C 桌面开发组件。三步跑通:轻量体验、专业工作流与 API 接入第 1 步 轻量体验:Gradio 网页生成目的:不开任何编辑器,浏览器里直接出模型。python gradio_app.py --low_vram_mode默认加载显存友好的 mini 版模型,纹理生成默认开启(加--disable_tex可关);想要文字生成入口就加--enable_t23d,显存充裕可把--model_path换成tencent/Hunyuan3D-2上完整精度。启动后打开 http://localhost:8080(默认端口),上传一张assets/example_images/里的图点生成,几十秒到几分钟后拿到textured_mesh.glb(贴图版)和white_mesh.glb(白模,方便自己重新上色)。第 2 步 专业工作流:装进 Blender目的:让建模师在熟悉的环境里出模型。Blender 3.0 走 编辑 → 偏好设置 → 插件 → 安装,选择仓库根目录的blender_addon.py;启用后 3D 视图侧边栏会出现 Hunyuan3D-2 3D Generator 面板,文本/图片生成与导出都在面板内完成,结果直接落到当前场景。详细步骤见 docs/source/started/blender.md。第 3 步 接入自有系统:启动 API 服务目的:把生成能力挂到自己的后端里。python api_server.py --host 0.0.0.0 --port 8080 --enable_tex--enable_tex打开纹理合成。调用/generate接口,图片传 base64 字符串:curl -X POST http://localhost:8080/generate \ -H Content-Type: application/json \ -d {\image\: \图片base64字符串\, \texture\: true} \ -o output.glb返回的响应体就是一个 GLB 文件。服务还暴露/send提交任务和/status/{uid}轮询结果,适合排队量大的异步场景。接口细节在 docs/source/started/api.md。参数怎么调:低配、中配、高配三档参考Hunyuan3D-2 是两段式流水线:前半段 Hunyuan3D-DiT 把图片/文字去噪成 3D 形状(源码在 hy3dgen/shapegen/),后半段 Hunyuan3D-Paint 给白模上贴图(hy3dgen/texgen/)。调优基本就是围绕这两段做:档位典型配置说明低配(8GB 显存)--model_path tencent/Hunyuan3D-2mini --low_vram_mode;API 侧octree_resolution用默认 128出图快、细节够用,适合验证想法中配(12GB)mini 版 --enable_flashvdm(turbo 加速);API 侧num_inference_steps从 5 提到 20~30速度与质量的折中,日常创作主力档高配(16GB)--model_path tencent/Hunyuan3D-2 --subfolder hunyuan3d-dit-v2-0 --low_vram_mode;API 侧octree_resolution提到 256、guidance_scale在 5~10 间试细节最丰富,耗时也最长几个参数各管一摊:octree_resolution控制网格精细度(越大越细、越吃显存);guidance_scale控制结果与输入的贴合度(越大越听话,多样性下降);face_count限制上贴图前的面数上限,默认 40000。落到实际场景:文物照片做数字存档,单图 中配参数就能拿到可 3D 打印的模型;电商商品图出展示模型,用白模加自研贴图更省事;产品评审要求多角度一致,仓库在assets/example_mv_images/备了前/后/左多视角样例,多视角模式会融合多个方向的信息,结构更稳。常见报错速查:症状与一行处方症状处方CUDA out of memory加--low_vram_mode、降octree_resolution、关纹理或换 mini 模型编译扩展报缺cl.exe换 x64 Native Tools Command Prompt for VS 2022 重跑 setup.pypip 安装互相冲突建虚拟环境后重装:python -m venv venv模型纹理糊、边缘毛刺提高num_inference_steps与octree_resolution首次启动卡很久正常现象,在自动下载权重;保持联网,或把--model_path指到本地权重目录继续深入:文档与源码入口入门文档(Gradio / API / Blender 各模式):docs/source/started/纯代码调用示例(批量生成、FlashVDM 加速):examples/形状生成模型与调度器源码:hy3dgen/shapegen/把 mini 版先跑起来,显存和手感都心里有数了,再按上面的档位往上加——这是最不容易翻车的路线。【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 一张图片生成可旋转 3D 模型:Hunyuan3D-2 本地部署与参数调优实操
一张图片生成可旋转 3D 模型:Hunyuan3D-2 本地部署与参数调优实操【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2手里只有一张产品照或一段文字描述,就想拿到能拖进 Blender、能在网页里转着看的 3D 模型?Hunyuan3D-2 把这事做成了本地就能跑的开源方案:图生 3D、文生 3D、多视角融合都支持,产出的 GLB 可以直接二次编辑。下文按先看效果 → 搭环境 → 跑通 → 调参数的顺序走一遍,命令均可直接复制。先看点效果:图生 3D 能到什么程度仓库自带一批真实产出,挑几张感受一下:官方展示图,卡通角色、静物、道具都能出。单图生成的话:输入assets/example_images/里任意一张参考图,出来的就是这种带贴图、能 360° 旋转的 GLB。文字生成同样可用,仓库里备好了提示词示例(assets/example_prompts.txt):本地部署:装 Python 依赖与编译两个渲染扩展环境要求压缩成一张表:项目要求系统Windows 10/11 64 位(Linux 也可跑)Python3.10.x显卡NVIDIA 独显,8GB 显存起步(跑 mini),12GB 以上更从容内存/磁盘16GB 内存,20GB 可用空间(首次要拉模型权重)拿到代码并装 Python 依赖:git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 cd Hunyuan3D-2 pip install -r requirements.txt依赖互相冲突的话,先python -m venv venv建个虚拟环境再装。纹理生成依赖两个 C/CUDA 扩展,需要手动编译——它们负责把 3D 表面画成图、再反推 UV 贴图:cd hy3dgen/texgen/custom_rasterizer python setup.py install cd ../../.. cd hy3dgen/texgen/differentiable_renderer python setup.py install cd ../../..报cl.exe not found说明不在正确的编译环境里:用 Visual Studio 2022 的 x64 Native Tools Command Prompt 打开终端重跑上面两条即可,前提是装 VS 时勾选了C 桌面开发组件。三步跑通:轻量体验、专业工作流与 API 接入第 1 步 轻量体验:Gradio 网页生成目的:不开任何编辑器,浏览器里直接出模型。python gradio_app.py --low_vram_mode默认加载显存友好的 mini 版模型,纹理生成默认开启(加--disable_tex可关);想要文字生成入口就加--enable_t23d,显存充裕可把--model_path换成tencent/Hunyuan3D-2上完整精度。启动后打开 http://localhost:8080(默认端口),上传一张assets/example_images/里的图点生成,几十秒到几分钟后拿到textured_mesh.glb(贴图版)和white_mesh.glb(白模,方便自己重新上色)。第 2 步 专业工作流:装进 Blender目的:让建模师在熟悉的环境里出模型。Blender 3.0 走 编辑 → 偏好设置 → 插件 → 安装,选择仓库根目录的blender_addon.py;启用后 3D 视图侧边栏会出现 Hunyuan3D-2 3D Generator 面板,文本/图片生成与导出都在面板内完成,结果直接落到当前场景。详细步骤见 docs/source/started/blender.md。第 3 步 接入自有系统:启动 API 服务目的:把生成能力挂到自己的后端里。python api_server.py --host 0.0.0.0 --port 8080 --enable_tex--enable_tex打开纹理合成。调用/generate接口,图片传 base64 字符串:curl -X POST http://localhost:8080/generate \ -H Content-Type: application/json \ -d {\image\: \图片base64字符串\, \texture\: true} \ -o output.glb返回的响应体就是一个 GLB 文件。服务还暴露/send提交任务和/status/{uid}轮询结果,适合排队量大的异步场景。接口细节在 docs/source/started/api.md。参数怎么调:低配、中配、高配三档参考Hunyuan3D-2 是两段式流水线:前半段 Hunyuan3D-DiT 把图片/文字去噪成 3D 形状(源码在 hy3dgen/shapegen/),后半段 Hunyuan3D-Paint 给白模上贴图(hy3dgen/texgen/)。调优基本就是围绕这两段做:档位典型配置说明低配(8GB 显存)--model_path tencent/Hunyuan3D-2mini --low_vram_mode;API 侧octree_resolution用默认 128出图快、细节够用,适合验证想法中配(12GB)mini 版 --enable_flashvdm(turbo 加速);API 侧num_inference_steps从 5 提到 20~30速度与质量的折中,日常创作主力档高配(16GB)--model_path tencent/Hunyuan3D-2 --subfolder hunyuan3d-dit-v2-0 --low_vram_mode;API 侧octree_resolution提到 256、guidance_scale在 5~10 间试细节最丰富,耗时也最长几个参数各管一摊:octree_resolution控制网格精细度(越大越细、越吃显存);guidance_scale控制结果与输入的贴合度(越大越听话,多样性下降);face_count限制上贴图前的面数上限,默认 40000。落到实际场景:文物照片做数字存档,单图 中配参数就能拿到可 3D 打印的模型;电商商品图出展示模型,用白模加自研贴图更省事;产品评审要求多角度一致,仓库在assets/example_mv_images/备了前/后/左多视角样例,多视角模式会融合多个方向的信息,结构更稳。常见报错速查:症状与一行处方症状处方CUDA out of memory加--low_vram_mode、降octree_resolution、关纹理或换 mini 模型编译扩展报缺cl.exe换 x64 Native Tools Command Prompt for VS 2022 重跑 setup.pypip 安装互相冲突建虚拟环境后重装:python -m venv venv模型纹理糊、边缘毛刺提高num_inference_steps与octree_resolution首次启动卡很久正常现象,在自动下载权重;保持联网,或把--model_path指到本地权重目录继续深入:文档与源码入口入门文档(Gradio / API / Blender 各模式):docs/source/started/纯代码调用示例(批量生成、FlashVDM 加速):examples/形状生成模型与调度器源码:hy3dgen/shapegen/把 mini 版先跑起来,显存和手感都心里有数了,再按上面的档位往上加——这是最不容易翻车的路线。【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考