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 资产卡在不会建模、外包又贵这一步Hunyuan3D-2 本地部署就是替代方案喂给它一张照片返回带纹理的高分辨率 3D 模型。Hunyuan3D-2 是腾讯开源的 3D 资产生成系统由形状生成模型 DiT 与纹理合成模型 Paint 两个阶段组成全程跑在你自己的 GPU 上。先认识一下这个项目两阶段生成带纹理的 3D 资产一句话定位它把一张图片或多视角图片变成可导出 glb/obj 的带纹理网格适合想把照片快速转成 3D 模型的游戏开发者、电商与文创从业者也适合想把 3D 生成能力嵌进自己工具链的工程师。几个可以在官方说明里核对到的事实显存门槛官方 Models Zoo 明确给出仅形状生成需 6GB 显存形状 纹理全流程需 16GB模型规格标准形状模型 Hunyuan3D-DiT-v2-0 为 1.1B 参数纹理模型 Hunyuan3D-Paint-v2-0 为 1.3B另有 0.6B 的 2mini 轻量版和 1.1B 的多视角版 2mv以及步数蒸馏的 Turbo 变体交付形态Gradio 网页、FastAPI 接口、Blender 插件、Python 代码四种入口输出为 trimesh 对象可直接存成 glb/obj图中左半部分是条件图经 DiT 扩散模型得到裸网格右半部分 Paint 把多视角特征贴回网格生成纹理贴图——理解这张图后文所有参数都有了对应位置。从零跑起来环境核对到首次生成核对运行环境系统Windows、Linux、macOS 均支持官方 Get Started 一节列出显卡NVIDIA CUDA 显卡只跑形状生成至少 6GB 显存要跑完整纹理流程按 16GB 准备PyTorch需先从 PyTorch 官网按你的 CUDA 版本安装requirements 里只装了生态库官方要求自行装 torch编译器编译纹理扩展需要 C 工具链Windows 装 Visual Studio Build Tools勾选 C 组件Linux 有 g 即可获取项目代码git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 cd Hunyuan3D-2预期现象目录里能看到gradio_app.py、api_server.py、hy3dgen/三项说明仓库完整。安装依赖并编译两个纹理扩展pip install -r requirements.txt # 生态库diffusers、trimesh、gradio 等 pip install -e . # 以可编辑方式安装 hy3dgen 包 # 纹理流程依赖的两个 C 扩展按官方顺序依次编译 cd hy3dgen/texgen/custom_rasterizer python3 setup.py install cd ../../.. cd hy3dgen/texgen/differentiable_renderer python3 setup.py install cd ../../..⚠️ 编译阶段报error: command cl failed或找不到 g原因是缺少 C 工具链。Windows 上装 Visual Studio Build Tools 后重开终端再试如果当前只用形状生成、暂时不做纹理这两个扩展可以跳过。用最轻的配置验证跑通首次启动会下载模型权重默认拉取 0.6B 的 2mini 形状模型 标准纹理模型耐心等进度条走完。python3 gradio_app.py \ --model_path tencent/Hunyuan3D-2mini \ --subfolder hunyuan3d-dit-v2-mini \ --texgen_model_path tencent/Hunyuan3D-2 \ --low_vram_mode # 显存紧张时启用低显存模式✅ 验证锚点终端打印 Running on http://0.0.0.0:8080端口默认 8080后浏览器出现 Gradio 页面。上传一张assets/example_images/里的示例图等生成结束能下载 .glb 文件拖进任意 glTF 查看器确认网格与纹理正常——跑通即成功。 若第一次启动长时间无输出多半在拉权重属正常现象之后会走本地缓存不再重复下载。实战3 个典型用法用法一Gradio 页面完成图片到带纹理 3D目标不写代码从网页上传一张照片得到成品模型。操作用标准 1.1B 模型替换上面的启动命令中的模型路径python3 gradio_app.py \ --model_path tencent/Hunyuan3D-2 \ --subfolder hunyuan3d-dit-v2-0 \ --texgen_model_path tencent/Hunyuan3D-2 \ --low_vram_mode若想要更快速度把 subfolder 换成hunyuan3d-dit-v2-0-turbo并加--enable_flashvdmFlashVDM 加速这是官方 README 的 Turbo 版命令组合。效果输入一张普通照片输出带纹理的 .glb官方展示效果见下——左侧为输入右侧为生成后旋转的成品几何贴合原图特征。这是官方仓库内的端到端展示图可以当作你对自己输出质量的心理预期基准。用法二起 API 服务把生成能力接进 Blender目标让 3D 生成成为你工作流的一环而不是一个玩具网页。操作# 启动服务默认模型为 2mini--enable_tex 开启纹理 python api_server.py --host 0.0.0.0 --port 8080 --enable_tex另开终端把本地图片编码后 POST 过去macOS/Linux 命令Windows 请改用 PowerShell 的certutil做 base64img_b64_str$(base64 -i assets/demo.png) # 本地图片转 base64 curl -X POST http://localhost:8080/generate \ -H Content-Type: application/json \ -d {image: $img_b64_str} \ -o test2.glb # 输出直接落成 glb 文件拿到 .glb 后导入 Blender安装 blender_addon.py编辑 → 偏好设置 → 插件 → 安装插件指向你刚起的 API 服务地址生成的模型直接进场景。更偏代码向的接入可以看 examples/ 里的官方示例Python API 两行即可拿到 trimesh 对象from hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline pipeline Hunyuan3DDiTFlowMatchingPipeline.from_pretrained(tencent/Hunyuan3D-2) mesh pipeline(imageassets/demo.png)[0] # trimesh 对象可 .export(out.glb)这张仓库自带的示例图可以直接当输入素材选主体单一、背景干净的图几何对齐效果更稳定。效果批量脚本里循环调用/generate就能批量出资产Blender 侧不用切换软件模型直接落地到场景里。服务并发上限由--limit-model-concurrency控制默认 5。用法三多视角图片换取更准的几何目标单张图片的背面、内侧只能靠模型脑补手里有产品各角度照片时改用多视角模型能明显提升结构准确度。操作把模型换成 2mv 系列1.1B 多视角形状模型其余参数不变python3 gradio_app.py \ --model_path tencent/Hunyuan3D-2mv \ --subfolder hunyuan3d-dit-v2-mv \ --texgen_model_path tencent/Hunyuan3D-2 \ --low_vram_mode效果assets/example_mv_images/目录按编号/前视图后视图左视图组织正是该入口需要的输入格式代码层面的完整用法见 examples/shape_gen_multiview.py 与多视角纹理版 examples/fast_texture_gen_multiview.py。多视角输入的正面图示例同一目录下的 back.png、left.png 与它组合提交。调优与排错参数怎么选、报错怎么处理常用启动参数速查以下参数来自 gradio_app.py 与 api_server.py 的实际定义参数作用推荐值适用配置--model_path/--subfolder选择形状模型16GBtencent/Hunyuan3D-2hunyuan3d-dit-v2-08~12GBtencent/Hunyuan3D-2minihunyuan3d-dit-v2-mini按显存档位选--low_vram_mode低显存模式降低峰值占用消费级显卡建议常开所有显存紧张的场景--enable_flashvdmFlashVDM 加速需搭配 turbo 版 subfolder如hunyuan3d-dit-v2-0-turbo追求速度时启用任意 CUDA 显卡--disable_tex关闭纹理生成只出裸网格调试几何结构时6GB 显存档--mc_algo网格提取算法默认mc默认即可通用--limit-model-concurrencyAPI 服务并发上限默认 5显存吃紧时调小多人/多脚本共用服务处理高频报错⚠️现象生成中途CUDA out of memory。原因形状与纹理模型同时驻留显存峰值约 16GB。解决加--low_vram_mode仍不够就换 0.6B 的 2mini 模型只想看几何可加--disable_tex把 6GB 档拉满。⚠️现象启动后终端打印端口被占用address already in use页面打不开。原因8080 默认端口已被占用API 服务与 Gradio 同机共存时尤其常见。解决Gradio 侧加--port 8090换端口两个服务共存时注意 API 服务默认端口是 8081别和 Gradio 的 8080 搞混。⚠️现象Windows 上python3 setup.py install报error: command cl failed。原因未安装 C 构建工具或终端不是 VS 开发者终端。解决安装 Visual Studio Build Tools 并勾选C 桌面开发从Developer Command Prompt重新执行只做形状生成可暂时跳过纹理扩展。跑通第一个模型只是起点建议下一步用你自己的产品图走一遍用法二的 API 批量链路把/generate接进现有脚本——那才是这套本地部署在真实工作里开始产生价值的地方。参考细节可查阅 docs/source/started/ 下的 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），仅供参考