本頁面由英文機器翻譯而成。閱讀英文原文。

Hunyuan3D-2.1 Shape(本機 3D 模型)

官方3DGPUv1.0.3aigd.model3d-hunyuan3d-2-1-shape
安裝 還沒安裝應用程式?免費下載
或在終端機中執行
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape
在你的電腦上執行。 只需下載一次模型,之後便在這台電腦的 GPU 上生成。

總覽

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

NVIDIA 10 GB 以上

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 形狀。」
  • 「為我剛加入的角色概念圖生成網格。」

重點特色

模型 IDaigd.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 模型

執行方式

不含 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.yaml0.00 GBTencent Hunyuan 3D 2.1 Community License檔案
hunyuan3d-dit-v2-1-model.fp16.ckpt7.37 GBTencent Hunyuan 3D 2.1 Community License檔案

模型的 Python 程式碼會在鎖定的 commit 從 GitHub 下載,每個檔案都以 sha256 檢查。

授權

  • 權重與推論程式碼:Tencent Hunyuan 3D 2.1 Community License(授權、模型卡;程式碼 hy3dshape/ 來自 GitHub 的 commit 82920d6)。

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 的可接受使用政策。

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

版本

Hunyuan3D-2.1 Shape(本機 3D 模型) 的發布版本
版本發布日期需搭配應用程式
1.0.3最新0.32.0-beta.6 或更新版本
1.0.20.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