Hunyuan3D-2.1 Shape(本地 3D 模型)
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape概览
本地图像转 3D:腾讯 Hunyuan3D-2.1 的形状模型可将一张图片变成高质量的无贴图 3D 网格(GLB),适用于游戏道具和角色,运行在你的 NVIDIA GPU 上,需要 10 GB 或以上显存。在 Local Python models runtime 中离线运行。未在欧盟、英国或韩国获得许可。
Hunyuan3D-2.1 Shape 可在你的 NVIDIA GPU(10 GB 或以上显存)上把一张图片变成高质量的 3D 形状,使用的是腾讯 Hunyuan3D-2.1 的形状模型。输出结果是无贴图的 GLB 网格。在 AI Game Dev 中,它通过 Local Python models runtime(aigd.python)本地运行。它适合希望为道具和角色获得精细基础网格、之后再另行贴图的开发者。它未在欧盟、英国或韩国获得许可。
你可以制作什么
- 从单张概念图生成道具、武器、家具、生物和角色的无贴图 3D 网格。
- 可供之后在你自己的工具中或用其他软件包贴图、重拓扑或绑定的基础网格。
- 从概念原画快速搭建 3D 粗模。
示例请求
- “用 Hunyuan3D 把
Concepts/treasure_chest.png变成 3D 模型。” - “用这张剑的图片(透明背景)生成一个 3D 形状。”
- “为刚添加的角色概念图生成网格。”
亮点
| 模型 ID | aigd.model3d-hunyuan3d-2-1-shape.v1 |
| 操作 | 图像转 3D(单张输入图像) |
| 输出 | 无贴图 GLB |
| 步数 | 默认 50 |
| 运行于 | NVIDIA GPU(CUDA),10 GB 或以上显存 |
| 下载 | 约 7.4 GB,首次加载时另需运行时的 Python 环境 |
| 许可 | Tencent Hunyuan 3D 2.1 Community License:不适用于欧盟、英国或韩国;月活跃用户超过 100 万需另行获得许可 |
其他本地图像转 3D 模型
- TripoSG 1.5B:无贴图,8 GB 显存。
- Step1X-3D Geometry:无贴图,16 GB 显存,Apache-2.0。
- TRELLIS.2 4B 和 Pixal3D:带 PBR 材质的贴图 GLB,在 NVIDIA 或 Vulkan GPU 上需 16 GB。
运行方式
不包含 Hunyuan3D-2.1 的 PBR 贴图模型。 它需要在你的电脑上编译自定义 CUDA 光栅化器,并把 Blender 作为 Python 模块使用,而应用的运行时不执行这些操作。请使用带有透明背景的单个物体图片。检查点是一个 PyTorch 文件,仅作为张量加载(weights_only=True),绝不会作为代码执行。
输出中可能包含一些小的分离部件:在对 TripoSG、Step1X-3D 和 Hunyuan3D 的 GPU 检查中,主体部分占面数的 97.5–99.2%。
此包只包含数据。它需要 Local Python models runtime(aigd.python),后者会在首次加载时为模型构建一个独立的 Python 环境(几 GB 的 PyTorch 和依赖库,详见该包的 README)。模型离线运行;其权重仅来自下面列出的文件,经你确认后从 Hugging Face 下载。AI Game Dev 不托管这些文件。
下载内容
约 7.4 GB,通过 Hugging Face 修订版本和 sha256 固定:
| 文件 | 大小 | 许可 | 来源 |
|---|---|---|---|
hunyuan3d-dit-v2-1-config.yaml | 0.00 GB | Tencent Hunyuan 3D 2.1 Community License | 文件 |
hunyuan3d-dit-v2-1-model.fp16.ckpt | 7.37 GB | Tencent Hunyuan 3D 2.1 Community License | 文件 |
模型的 Python 代码从 GitHub 按固定的提交下载,每个文件均通过 sha256 校验。
许可
hy3dshape 的文件头提到“非商业”许可;但仓库中的 LICENSE(见上)是 Community License,适用的是后者。
必须的署名(Notice):"Tencent Hunyuan 3D 2.1 is licensed under the Tencent Hunyuan 3D 2.1 Community License Agreement, Copyright © 2025 Tencent. All Rights Reserved. The trademark rights of "Tencent Hunyuan" are owned by Tencent or its affiliate."
限制:
- 未在欧盟、英国或韩国获得许可。 你不得在这些地区使用该模型或其输出。
- 月活跃用户超过 100 万的产品或服务需要获得腾讯的单独许可。
- 不得将该模型及其输出用于改进任何其他 AI 模型。
- 适用腾讯的可接受使用政策。
你有责任确认你的使用方式是被允许的。
版本
| 版本 | 发布时间 | 需要应用 |
|---|---|---|
| 1.0.3最新 | 0.32.0-beta.6 或更高版本 | |
| 1.0.2 | 0.32.0-beta.6 或更高版本 |
安装
在桌面应用中安装
打开包窗口(状态栏中的包图标),选择浏览,搜索 aigd.model3d-hunyuan3d-2-1-shape,然后点击添加到项目。
还没安装应用?免费下载 AI Game Dev,支持 Windows、macOS 和 Linux。
从终端安装
在项目文件夹中使用 gamedev CLI:
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape环境要求
- AI Game Dev 0.32.0-beta.6 或更高版本
- NVIDIA GPU,10 GB 显存或以上
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape