Hunyuan3D-2 Windows 本地部署指南图片变 3D 模型的一站式教程【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2想把自己的一张图片变成可旋转的 3D 模型却不想依赖在线服务想跑起来 Hunyuan3D-2却被环境依赖和 C 扩展编译卡住这篇 Hunyuan3D-2 本地部署教程带你走完 Windows 上的全部流程。读完本文你将获得一份可直接照做的 Windows 环境搭建清单Python、编译器、Python 依赖、C 扩展三种落地方式的可复制命令Gradio 图形界面、Blender 插件、API 服务一套「快速预览 / 标准质量 / 高细节输出」的参数配置参考编译失败、显存不足等高频问题的排查动作它是什么两阶段架构 30 秒速览这节帮你先建立整体认知后面所有操作都围绕这套架构展开。Hunyuan3D-2 是腾讯混元系列的高分辨率 3D 资产生成系统采用「先生成几何、再合成纹理」的两阶段流水线第一阶段由几何生成模型 Hunyuan3D-DiT 根据条件图产出带细节的裸网格第二阶段由纹理合成模型 Hunyuan3D-Paint 为生成或手工制作的网格烘焙高分辨率贴图。两个阶段解耦意味着你可以只跑几何也可以给已有模型补纹理。核心组件包括Hunyuan3D-DiT基于流式扩散 Transformer 的几何生成模型源码见 hy3dgen/shapegen/Hunyuan3D-Paint纹理合成模型源码见 hy3dgen/texgen/部署入口gradio_app.py 图形界面、blender_addon.py 插件、api_server.py 后端服务环境与安装先装对依赖后面才不折腾这节解决的问题是在 Windows 上跑起来之前到底要装哪些东西、按什么顺序装。前置工具清单Python 3.10.x安装时勾选 Add Python to PATHVisual Studio 2022安装「使用 C 的桌面开发」组件用于编译 C 扩展NVIDIA 显卡 对应 CUDA 驱动Git第一步克隆仓库git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 cd Hunyuan3D-2第二步安装 Python 依赖PyTorch 建议先到官方安装页选择匹配你 CUDA 版本的命令安装其余依赖一次性装完pip install -r requirements.txt pip install -e .requirements.txt 中已包含 diffusers、torch、trimesh、pymeshlab、gradio、onnxruntime、rembg 等核心库。第三步编译两个 C 扩展纹理生成必需cd hy3dgen/texgen/custom_rasterizer python setup.py install cd ../../.. cd hy3dgen/texgen/differentiable_renderer python setup.py install cd ../../..⚠️ 如果编译时提示找不到cl.exe或 pybind11说明当前终端没有加载 MSVC 编译环境请以管理员身份打开「x64 Native Tools Command Prompt for VS 2022」重新执行上面的命令缺 pybind11 则先执行pip install pybind11。运行与体验按你的角色选一种方式这节按人群分层每种方式都给出启动命令和典型用法直接照抄即可。️ 图形界面新手推荐路径Gradio 界面提供文本 / 图片 / 多视角三种输入适合第一次体验。启动标准模型并开启低显存模式python gradio_app.py --model_path tencent/Hunyuan3D-2 --subfolder hunyuan3d-dit-v2-0 --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode启动后浏览器自动打开。关键参数Octree Resolution八叉树分辨率滑块默认 256越高细节越多、耗时越长纹理开关勾选后输出带贴图的 GLB 模型。测试图可以直接用仓库自带的 assets/example_images/example_000.png多视角模式下可上传前 / 后 / 左 / 右视图参考素材在 assets/example_mv_images/。 Blender 插件专业工作流集成适合已经在 Blender 里做资产的用户。插件依赖 API 服务先启动后端python api_server.py --host 0.0.0.0 --port 8080然后在 Blender3.0中进入「编辑 偏好设置 插件」选择 blender_addon.py 安装并启用在 3D 视图侧边栏找到 Hunyuan3D-2 面板即可输入提示词或参考图生成并直接导入当前场景。使用教程见 docs/source/started/blender.md。‍ API 调用开发集成适合把生成能力嵌入自己的应用。服务启动后向/generate发送 POST 请求即可参考 docs/source/started/api.mdimg_b64_str$(base64 -i assets/demo.png) curl -X POST http://localhost:8080/generate \ -H Content-Type: application/json \ -d {image: $img_b64_str, texture: true} \ -o output.glb请求体中常用字段num_inference_steps推理步数默认 5、guidance_scale引导尺度默认 5.0、seed种子、texture是否生成纹理。参数调优速度、质量、显存的平衡术这节解决的问题是不同硬件和场景下参数到底怎么配。硬件需求官方给出的显存参考为——仅几何生成约 6 GB几何 纹理全流程约 16 GB内存建议 16 GB 起。场景推荐配置预期效果快速预览mini 模型 --low_vram_modeOctree 128数分钟出几何验证提示词是否有效标准输出标准模型Octree 256界面默认值细节与耗时均衡日常出图首选高细节交付标准模型Octree 384增大推理步数细节更丰富耗时明显增加提速技巧启动时加--enable_flashvdm配合 Turbo 子文件夹如--subfolder hunyuan3d-dit-v2-0-turbo可显著压缩扩散推理时间显存紧张时优先加--low_vram_mode或改用tencent/Hunyuan3D-2mini小模型避坑指南四个高频问题的标准答案这节集中回答部署时最容易卡住的几个点。Q编译 C 扩展时报「cl.exe not found」或链接错误A确认当前终端是 VS 2022 的原生工具命令行管理员身份启动并且 VS 已装「使用 C 的桌面开发」组件再补装pip install pybind11 ninja后重试。Q运行时报 CUDA out of memoryA先加--low_vram_mode仍不够就换 mini 模型--model_path tencent/Hunyuan3D-2mini并把八叉树分辨率降到 128。Q生成的模型没有纹理A确认三件事界面里勾选了纹理生成或 API 中传了texture: true启动时带了--texgen_model_path两个 C 扩展custom_rasterizer、differentiable_renderer都编译成功。QBlender 插件连不上服务A先手动访问http://localhost:8080确认 API 服务已在监听返回非连接失败即可再核对插件设置里的 API 地址与端口是否一致。延伸资源继续深挖的路标入门文档docs/source/started/index.md含代码调用、ComfyUI、Gradio 等分册API 说明docs/source/started/api.md提示词库assets/example_prompts.txt可直接粘贴进界面测试高级示例脚本多视角生成、FlashVDM 加速等examples/技术报告assets/report/Tencent_Hunyuan3D_2_0.pdf社区衍生工具项目 README 中收录了 Windows 整合包、ComfyUI 节点封装等社区扩展可结合需要查阅准备好显卡和一杯咖啡按上面的顺序把环境装好你的第一个 3D 资产离得很近。提示模型权重首次运行时会自动下载建议在网络稳定时段启动生成高质量模型时合理设置推理步数与八叉树分辨率用相同seed配合不同提示词还能得到风格一致的系列资产。【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考