# Hunyuan3D-2.1 Shape（本地 3D 模型）

> 本地图像转 3D：腾讯 Hunyuan3D-2.1 的形状模型可将一张图片变成高质量的无贴图 3D 网格（GLB），适用于游戏道具和角色，运行在你的 NVIDIA GPU 上，需要 10 GB 或以上显存。在 Local Python models runtime 中离线运行。未在欧盟、英国或韩国获得许可。

- ID: `aigd.model3d-hunyuan3d-2-1-shape`
- 来源: 官方 (第一方 `aigd.*`)
- 分类: 3D
- 发布者: AI Game Dev (`aigd`), 已验证
- 最新版本: 1.0.3 (发布于 2026-11-22)
- 许可证: SEE LICENSE IN README.md
- 需要 AI Game Dev 应用: `>=0.32.0-beta.6`
- 原生代码: 否
- 评分: 暂无评分
- HTML 页面: https://ai-game.dev/zh-hans/packages/aigd.model3d-hunyuan3d-2-1-shape

## 安装

使用 gamedev CLI，在项目文件夹中运行：

```bash
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape
```

在桌面应用中：打开 Packages 窗口（状态栏中的包图标），选择 **Browse**，搜索 `aigd.model3d-hunyuan3d-2-1-shape`，然后点击 **Add to Project**。更多：https://ai-game.dev/docs/wiki/app/packages

## 版本

| 版本 | 发布时间 | 需要应用 | 备注 |
|---|---|---|---|
| 1.0.3 | 2026-11-22 | `>=0.32.0-beta.6` | 最新 |
| 1.0.2 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## 描述

````markdown
# Hunyuan3D-2.1 Shape (`aigd.model3d-hunyuan3d-2-1-shape`)

Hunyuan3D-2.1 Shape 可在你的 NVIDIA GPU（10 GB 或以上显存）上把一张图片变成高质量的 3D 形状，使用的是腾讯 [Hunyuan3D-2.1](https://github.com/Tencent-Hunyuan/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](https://ai-game.dev/packages/aigd.model3d-triposg)：无贴图，8 GB 显存。
- [Step1X-3D Geometry](https://ai-game.dev/packages/aigd.model3d-step1x-3d-geometry)：无贴图，16 GB 显存，Apache-2.0。
- [TRELLIS.2 4B](https://ai-game.dev/packages/aigd.model3d-trellis2-4b) 和 [Pixal3D](https://ai-game.dev/packages/aigd.model3d-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 | [文件](https://huggingface.co/tencent/Hunyuan3D-2.1/resolve/0b94677654c57bb9a6b6845cd7b704ccf551d327/hunyuan3d-dit-v2-1/config.yaml) |
| `hunyuan3d-dit-v2-1-model.fp16.ckpt` | 7.37 GB | Tencent Hunyuan 3D 2.1 Community License | [文件](https://huggingface.co/tencent/Hunyuan3D-2.1/resolve/0b94677654c57bb9a6b6845cd7b704ccf551d327/hunyuan3d-dit-v2-1/model.fp16.ckpt) |

模型的 Python 代码从 GitHub 按固定的提交下载，每个文件均通过 sha256 校验。

## 许可

- **权重与推理代码：Tencent Hunyuan 3D 2.1 Community License**（[许可](https://huggingface.co/tencent/Hunyuan3D-2.1/blob/0b94677654c57bb9a6b6845cd7b704ccf551d327/LICENSE)、[模型卡](https://huggingface.co/tencent/Hunyuan3D-2.1/tree/0b94677654c57bb9a6b6845cd7b704ccf551d327)；代码 `hy3dshape/` 来自 GitHub，提交为 [`82920d6`](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1/tree/82920d643c0dc2f7bfd7255f45f62d386edfe60c)）。

`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 模型。
- 适用腾讯的可接受使用政策。

你有责任确认你的使用方式是被允许的。
````
