Hunyuan3D-2 实用指南从一张图到带纹理的3D模型4种部署入口对比【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2产品图给到一张角色概念图甲方问能不能变成3D资产而你连建模软件都没打开过。Hunyuan3D-2 就是为这个场景准备的腾讯开源的大规模3D资产生成系统输入一张图片输出带几何和纹理的高分辨率3D模型推理代码、模型权重与技术报告全部在仓库里。本文按先跑通、再选模型、最后进阶的顺序把它的两个核心模型、4种部署入口和显存门槛一次讲清。先分清分工图生3D在这里是怎么发生的系统由两个基础模型协作Hunyuan3D-DiT负责形状Hunyuan3D-Paint负责纹理。流程是两阶段DiT 基于流式扩散 Transformer从输入图像生成无纹理网格几何会被刻意对齐到条件图随后 Paint 利用几何与扩散先验给网格合成一张高分辨率纹理图。整个流程的输出是标准 trimesh 对象能直接导出 glb 或 obj。仓库里自带几十张示例图放在 assets/example_images/ 下Gradio 页面会直接加载它们供你一键体验。两阶段拆分有个实打实的好处纹理模型不只服务它自己生成的网格你在 Blender 里手工建的模型同样可以交给 Paint 上色。 先看显存再决定下载哪个模型按官方口径只跑形状生成约需6GB 显存形状加纹理全流程约需 16GB。显卡不够时不用硬扛仓库给了三条退路0.6B 的 mini 系列、Gradio 的--low_vram_mode参数以及配合 turbo 模型使用的 FlashVDM 加速框架。模型系列参数量定位适合谁Hunyuan3D-DiT-v2-01.1B默认图生3D形状模型全能选项另有 Fast/Turbo 加速版Hunyuan3D-DiT-v2-mini0.6B轻量形状模型低显存、快速验证想法Hunyuan3D-DiT-v2-mv1.1B多视图前/后/左/右图生3D单图细节不够时Hunyuan3D-Paint-v2-01.3B纹理生成也可给手工网格上色Hunyuan3D-Delight-v2-01.3B图像 delight光照净化上纹理前的预处理环节Hunyuan3D-2.1 系列3.0B 形状 / 1.3B 纹理新一代支持 PBR 材质追求最新质量后缀有讲究Turbo 是步数蒸馏采样步数更少Fast 是引导蒸馏官方称可把 DiT 推理时间减半。拿不准就先下 DiT-v2-0 加 Paint-v2-0 的组合跑不动再换 mini。4个入口随便玩玩、接业务还是3D美术克隆一次仓库之后按用途选路git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2依赖安装跟着 README 走其中纹理相关的两个光栅化组件需要单独编译安装。之后你有四条路入口文件适合谁Gradio 页面gradio_app.py随便玩玩显存小就加--low_vram_modeAPI 服务api_server.py把图生3D接进自己的产品最小脚本minimal_demo.py把两阶段流程嵌进自己的代码Blender 插件blender_addon.py3D 美术需先起 API 服务Gradio 页面开箱即用示例图和提示词都预置好了传图即出模型API 服务监听默认 8080 端口支持图生3D、文生3D和给已有网格上纹理向/generate发送 base64 编码的图片即可取回 glb 文件Blender 插件让你在编辑器里直接调模型省得来回复制文件。第一个模型5行代码跑通两阶段流程代码入口看 minimal_demo.py 就够了它就是参考实现读入图片是 RGB 就先抠掉背景BackgroundRemover过形状管线得到网格再过纹理管线得到贴图最后mesh.export(demo.glb)收尾。核心加载部分只有5行from hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline from hy3dgen.texgen import Hunyuan3DPaintPipeline shape_pipe Hunyuan3DDiTFlowMatchingPipeline.from_pretrained(tencent/Hunyuan3D-2) tex_pipe Hunyuan3DPaintPipeline.from_pretrained(tencent/Hunyuan3D-2)API 是 diffusers 风格两条管线都用from_pretrained加载之后把 mesh 和条件图分别喂给两条管线即可。只想要无纹理模型的话更简单mesh shape_pipe(imageassets/demo.png)[0]一行搞定。 生成的模型不够准去 examples 目录找进阶玩法examples/ 里的脚本按场景组织一个文件对应一种玩法照着抄参数就行多视图输入shape_gen_multiview.py配 mv 系列模型同时吃前、后、左、右四个视角样例视图在assets/example_mv_images/文生3Dhy3dgen/text2image.py封装了 Hunyuan DiT先用文字出概念图再进3D流程API 服务的文生3D走的就是这条路加速推理fast_shape_gen_with_flashvdm.py、faster_shape_gen_with_flashvdm_mini_turbo.pyturbo 模型叠 FlashVDM给已有网格上纹理textured_shape_gen.py单图重建不了背面细节时换多视图输入是最直接的升级比调任何参数都管用。网格拿到手后还有一步收尾hy3dgen/texgen/ 的 utils 里备好了去高光dehighlight、网格简化、UV 修复等模块API 服务里挂的 FloaterRemover、FaceReducer 等后处理也是同一套东西批量出资产时省不少手工活。 速查表想做什么就翻哪里你想做的事怎么做去哪里看快速体验克隆后启动 Gradio 页面gradio_app.py生成无纹理模型形状管线4行代码examples/shape_gen.py生成带纹理模型两阶段管线minimal_demo.py多视图输入mv 系列模型加四张视角图examples/shape_gen_multiview.py给自己的网格上纹理Paint 管线examples/textured_shape_gen.py加速推理Turbo/Fast 变体或 FlashVDMexamples/fast_shape_gen_with_flashvdm.py文字描述直接出3Dtext2image 先生图再进流程api_server.py最后交代一下边界推理代码、模型权重、技术报告、ComfyUI 支持和微调代码官方开源清单里都已勾掉目前只欠一个 TensorRT 版本。各入口的详细参数和教程文档在 docs/source/started/卡住时按上表的顺序翻基本不用到处搜。【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考