AI 3D生成本地部署15分钟出带纹理3D【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2Hunyuan3D-2是腾讯开源的AI 3D生成工具能把文字或一张图片变成带纹理的3D模型。做游戏资产、把照片转3D都能用它。下面带你从零跑通第一个模型。1. 克隆仓库到装完依赖只需三步官方支持 Windows、macOS、Linux 三个系统。Windows 用户建议先装好 Visual Studio 2022勾选C 桌面开发组件后面编译 C 扩展要用。内存 16GB 以上显卡建议 NVIDIA。克隆仓库并进入目录git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 cd Hunyuan3D-2安装 Python 依赖和项目包pip install -r requirements.txt pip install -e .编译纹理生成用到的两个 C 扩展从仓库根目录依次执行cd hy3dgen/texgen/custom_rasterizer python setup.py install cd ../../differentiable_renderer python setup.py install如果编译时提示 cl.exe not found说明 Windows 没有构建环境打开 x64 Native Tools Command Prompt for VS 2022 重新执行即可Linux 上先装g和make。如果你只打算做形状生成这一步可以跳过。按显存选启动参数显卡显存推荐组合预期耗时24GB 以上全量模型 纹理3-5 分钟12-16GB全量模型 --low_vram_mode5-8 分钟8GB--model_path tencent/Hunyuan3D-2mini 分辨率 1282-4 分钟2. 启动 Gradio 界面生成第一个 3D 在仓库根目录执行带上--enable_t23d解锁文字模式python gradio_app.py --enable_t23d --model_path tencent/Hunyuan3D-2 --subfolder hunyuan3d-dit-v2-0 --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode启动。模型加载完成后浏览器会打开http://localhost:8080。选模式。左侧 Image Prompt 标签页就是默认的图片转 3DText Prompt 是文字模式。想试多视角合成重启时把--model_path换成tencent/Hunyuan3D-2mv界面会出前、后、左、右四个图位。填输入。图片标签页上传你的图右侧示例图库可以直接点选文字标签页用一句话描述比如a cute cartoon penguin wearing red。等结果。点 Gen Shape 出白模点 Gen Textured Shape 出带纹理模型页面里可以直接旋转查看Export 标签页下载 glb/obj 文件。文字模式的效果一句话描述出来的卡通企鹅结构完整度不错。图片模式的效果上传单张卡通角色图身体细节和比例都能保留下来。换成雕塑的真实照片同样能拿到可用的形状。3. 在 Blender 里直接出 3D 模型或用 API 接入你的应用如果你习惯在 Blender 里工作三步装插件 → 找面板 → 生成。先启动 API 服务前提条件然后 Blender3.0 以上里 编辑 偏好设置 插件 安装选中blender_addon.py。启用后在 3D 视图按 N 打开侧边栏找到 Hunyuan3D-2 3D Generator 面板输入文字或选一张图点 Generate模型直接落到当前场景可以继续雕刻或烘焙。如果你想接入自己的应用先启动服务再把图片的 base64 发给/generate接口返回的就是 .glb 文件python api_server.py --host 0.0.0.0 --port 8080 --enable_tex 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, texture: true} -o output.glb4. 分辨率、步数、引导强度真正影响质量的参数Hunyuan3D-2 的 AI 3D 生成是两阶段流程Hunyuan3D-DiT 先根据你的输入捏出形状Hunyuan3D-Paint 再给它上色。因为解耦了你自己的模型也能单独送进上色这一步。真正需要动的参数就这四个参数作用推荐值Octree Resolution几何细节与显存256要细节拉到 384显存紧张降到 128推理步数越多越稳但更慢30Turbo 模式可降到 5Guidance Scale与输入贴合程度5.0-7.5越高越贴合、多样性越低模型大小mini 版显存更低、速度更快--model_path tencent/Hunyuan3D-2mini切换拿不准就用默认值先跑通再逐个调。5. 显存爆了、编译报错、纹理模糊三个高频问题遇到 CUDA out of memory 时。官方数据是形状生成约 6GB 显存、形状 纹理共约 16GB。加--low_vram_mode、把 octree 分辨率降到 128或换 mini 模型。遇到编译报错时。提示 cl.exe not found 或找不到g都是缺 C 构建环境。Windows 用 x64 Native Tools 命令行Linux 先装 build-essential。生成纹理偏模糊时。先把推理步数提到 50再调高 octree 分辨率纹理模型可以试 Turbo 版本速度更快、效果接近。6. 延伸阅读与成果画廊 ️docs/source/— 官方文档含安装、Gradio、Blender 插件、ComfyUI 接入等教程examples/— 10 个可直接跑的示例脚本多视角生成、Turbo 加速、单独纹理化assets/example_images/— 几十个示例输入图挑一张就能上手现在轮到你了从assets/example_images/里挑一张图丢进去试试。【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
