Hunyuan3D-2.1 Shape(本機 3D 模型)
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape總覽
本機影像轉 3D:Tencent Hunyuan3D-2.1 的形狀模型能把單張影像變成高品質、未貼材質的 3D 網格(GLB),適合遊戲道具與角色,在你的 NVIDIA GPU 上執行,需 10 GB 以上 VRAM。於本機 Python 模型執行環境中離線執行。未在歐盟、英國或南韓取得授權。
Hunyuan3D-2.1 Shape 透過 Tencent 的 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:未貼材質,8 GB VRAM。
- Step1X-3D Geometry:未貼材質,16 GB VRAM,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% 的面。
此套件僅含資料。它需要 本機 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 | 檔案 |
hunyuan3d-dit-v2-1-model.fp16.ckpt | 7.37 GB | Tencent Hunyuan 3D 2.1 Community License | 檔案 |
模型的 Python 程式碼會在鎖定的 commit 從 GitHub 下載,每個檔案都以 sha256 檢查。
授權
- 權重與推論程式碼:Tencent Hunyuan 3D 2.1 Community License(授權、模型卡;程式碼
hy3dshape/來自 GitHub 的 commit82920d6)。
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 的可接受使用政策。
你有責任確認自己的使用方式是否被允許。
版本
| 版本 | 發布日期 | 需搭配應用程式 |
|---|---|---|
| 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