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

> 本機影像轉 3D：Tencent Hunyuan3D-2.1 的形狀模型能把單張影像變成高品質、未貼材質的 3D 網格（GLB），適合遊戲道具與角色，在你的 NVIDIA GPU 上執行，需 10 GB 以上 VRAM。於本機 Python 模型執行環境中離線執行。未在歐盟、英國或南韓取得授權。

- 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-hant/packages/aigd.model3d-hunyuan3d-2-1-shape

## 安裝

在專案資料夾中，使用 gamedev CLI：

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

在桌面應用程式中：開啟「套件」視窗（狀態列上的套件圖示），選擇 **瀏覽**，搜尋 `aigd.model3d-hunyuan3d-2-1-shape`，然後點 **加入專案**。更多資訊：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 透過 Tencent 的 [Hunyuan3D-2.1](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1) 形狀模型，在你的 NVIDIA GPU（10 GB 以上 VRAM）上把單張影像變成高品質的 3D 形狀。結果是未貼材質的 GLB 網格。在 AI Game Dev 中，它透過 **本機 Python 模型執行環境**（`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 以上 VRAM |
| 下載 | 約 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 VRAM。
- [Step1X-3D Geometry](https://ai-game.dev/packages/aigd.model3d-step1x-3d-geometry)：未貼材質，16 GB VRAM，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% 的面。

此套件僅含資料。它需要 **本機 Python 模型執行環境**（`aigd.python`），該環境會在首次載入時為模型建立專屬的 Python 環境（數 GB 的 PyTorch 與函式庫，詳見該套件的 README）。模型離線執行；權重只來自下列檔案，並在你確認後從 Hugging Face 下載。AI Game Dev 不代為託管。

## 會下載哪些內容

約 7.4 GB，以 Hugging Face revision 與 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 程式碼會在鎖定的 commit 從 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 的 commit [`82920d6`](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1/tree/82920d643c0dc2f7bfd7255f45f62d386edfe60c)）。

`hy3dshape` 的檔案標頭提到「non-commercial」授權；但儲存庫的 `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 萬**的產品或服務，需向 Tencent 另行取得授權。
- 該模型及其輸出不得用於改進任何其他 AI 模型。
- 適用 Tencent 的可接受使用政策。

你有責任確認自己的使用方式是否被允許。
````
