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

TRELLIS.2 4B(3D 模型)

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

總覽

本機影像轉 3D:Microsoft 的 TRELLIS.2 4B 能把單張影像變成貼圖完整的 3D 模型(含 UV 貼圖集與 PBR 材質的 GLB),可用於遊戲素材,解析度為 512、1024 或 1536。透過 trellis.cpp 在具備 16 GB 顯示記憶體的 NVIDIA 或 Vulkan GPU 上執行。授權為 MIT,影像編碼器另採 Meta 的 DINOv3 授權。

TRELLIS.2 4B 是 Microsoft 的 TRELLIS.2 影像轉 3D 模型。它能把單張影像變成貼圖完整的 3D 模型:一個含 UV 貼圖集與 PBR 材質(基礎色、金屬度、粗糙度)的 GLB,在解析度 1024 下約有 300,000 個面。在 AI Game Dev 中,它會透過 Local 3D generation(aigd.trellis,trellis.cpp)在你的 GPU 上執行,需要具備 16 GB 顯示記憶體的 NVIDIA(CUDA)或 Vulkan GPU。它適合想從概念美術取得貼圖素材、又不想依賴雲端服務的開發者。

你可以製作的內容

  • 從一張照片或概念圖,做出帶貼圖、可直接用於 PBR 的道具、武器、家具、載具與角色。
  • 從一般照片生成模型:背景會自動去除(BiRefNet)。
  • 解析度 512 的較輕量草稿,或 1536 的更精細模型。

範例指令

  • 「用 TRELLIS.2 把 Concepts/potion.png 變成貼圖完整的 3D 模型。」
  • 「先把我這台舊收音機的這張照片做成解析度 512 的貼圖 GLB,好讓我快速確認一下。」
  • 「以 1536 解析度生成騎士概念的 3D 模型。」

重點特色

模型 IDaigd.model3d-trellis2-4b.f16
操作影像轉 3D(單張 PNG 或 JPEG 影像)
輸出含 UV 貼圖集與 PBR 材質的貼圖 GLB(PNG 貼圖)
解析度512、1024(預設)、1536
步數預設 12
執行環境具備 16 GB 顯示記憶體的 NVIDIA(CUDA)或 Vulkan GPU
下載16.5 GB,10 個檔案
授權MIT;DINOv3 編碼器採用 Meta 的 DINOv3 License

TRELLIS.2 或 Pixal3D

兩者都在 Local 3D generation 上執行,並產生貼圖 GLB。

  • TRELLIS.2 4B(本套件):基礎模型,另外提供較輕量的 512 解析度。
  • Pixal3D:Tencent ARC 以 TRELLIS.2 微調的版本,會更貼近照片的輪廓;僅支援 1024 與 1536 解析度。它與 TRELLIS.2 共用 3.5 GB 的檔案,因此兩者合計約 27 GB。

若要在 NVIDIA GPU 上取得無貼圖網格,請參閱 TripoSG、Hunyuan3D-2.1 Shape 與 Step1X-3D Geometry。

限制與實測

  • 輸入: 一張 PNG 或 JPEG 影像,內容為單一物件。背景會自動去除(BiRefNet),因此一般照片也能用;本身已含透明度的影像會保留其透明度。
  • 輸出: 一個完整的獨立 GLB(PNG 貼圖)。
  • 解析度: 512(較輕量)、1024(預設,512→1024 串接流程)、1536。
  • 一律貼圖: 不提供僅產生幾何的執行模式。trellis.cpp v0.8.1 只在貼圖時簡化網格,因此若不貼圖,它會寫出原始解碼網格(實測 15.67 百萬個面),超出應用程式的 GLB 限制。沒有任何執行期旗標能在其他情況下簡化網格。
  • 非位元一致: 相同的影像、種子與設定不會產生位元一致的 GLB。兩次以種子 42 執行的 CUDA 執行都產生了有效的 GLB,但幾何與 SHA-256 雜湊不同;記錄下來的種子僅代表該次請求的設定。
  • 硬體: 具備 16 GB 顯示記憶體的 NVIDIA(CUDA)或 Vulkan GPU。上游指出 1024 串接流程可在 16 GB 顯示卡上執行,並在 RTX 5060 Ti 16 GB 上實測每個模型 3:16–7:23(Radeon 8060S iGPU 為 6:09–12:39),已包含模型載入時間。
  • 下載: 16.5 GB,10 個檔案。

在 Windows 上搭配 RTX 4090,以種子 42、12 步生成一張影像,得到以下端到端時間與整張裝置的 VRAM 峰值。起始 VRAM 用量為 3,676–4,819 MiB。

後端解析度時間VRAM 峰值
CUDA51260.77 s7,321 MiB
CUDA1024290.88 s10,166 MiB
CUDA1536687.35 s14,857 MiB
Vulkan512147.04 s7,558 MiB
Vulkan1024710.54 s13,447 MiB

下載內容

全部來自 ilintar/trellis2-gguf 的修訂版 a57397bd3d351599d9729fc144b3f87c3f87d65b(F16 權重、F32 正規化參數),並以 sha256 校驗:

檔案內容說明來源模型授權
ss_flow, shape_flow_512, shape_flow_1024, tex_flow_512, tex_flow_1024三個階段的 1.3B flow transformer(形狀與貼圖各有兩種解析度)microsoft/TRELLIS.2-4BMIT
shape_dec, tex_dec形狀與貼圖解碼器microsoft/TRELLIS.2-4BMIT
ss_dec稀疏結構解碼器microsoft/TRELLIS-image-largeMIT
dinov3DINOv3 ViT-L/16 影像編碼器timm/vit_large_patch16_dinov3.lvd1689m(Meta 的 DINOv3)DINOv3 License
birefnet背景移除ZhengPeng7/BiRefNetMIT

授權

TRELLIS.2 為 MIT 授權:允許商業使用,你產生的內容歸你所有(由於下方 DINOv3 編碼器的使用限制,應用程式會在下載前請你接受授權)。有一個元件不是 MIT:

  • DINOv3 影像編碼器(dinov3.gguf)——Meta 的 DINOv3 License(2025 年 8 月 14 日)。這是全球適用、免費且免權利金的授權,允許商業使用,但附帶以下條件:
    • 若你散布此編碼器或其衍生物,必須附上 DINOv3 License 的副本,並在相關網站、使用者介面、部落格文章、關於頁面或產品文件中顯著展示 "Built with DINOv3"。
    • 不得用於受 ITAR 規範的活動,或受貿易管制禁止的最終用途:軍事或戰爭、核子產業或應用、間諜活動,以及槍械與非法武器。你不得為貿易制裁的對象。
    • 不得對底層元件進行逆向工程。若你違反授權,或就這些素材對 Meta 提起訴訟,Meta 可終止授權。
  • GGUF 儲存庫 ilintar/trellis2-gguf 宣告授權為「other」,並指向來源模型;它本身不附加任何條款。
  • Meta 的授權頁面(2025 年 8 月 14 日,上方已連結)包含 "Built with DINOv3" 義務;隨 DINOv3 程式碼附上的副本(2025 年 8 月 19 日)則沒有。本套件遵循較嚴格的那一份。

必要的署名文字:

TRELLIS.2 © Microsoft Corporation (MIT). Built with DINOv3 (DINOv3 License, © Meta Platforms). BiRefNet © ZhengPeng7 (MIT).

限制簡單來說:上述的 DINOv3 署名要求,以及其軍事/武器/貿易管制禁令。沒有營收上限、沒有地區限制、沒有浮水印。

所有檔案皆從 Hugging Face 下載。AI Game Dev 不代為託管。下載模型即表示你接受這些授權。

版本

TRELLIS.2 4B(3D 模型) 的發布版本
版本發布日期需搭配應用程式
1.0.5最新0.32.0-beta.6 或更新版本
1.0.40.32.0-beta.6 或更新版本

安裝

在桌面應用程式中

開啟 套件 視窗(狀態列上的套件圖示),選擇 瀏覽,搜尋 aigd.model3d-trellis2-4b,然後點選 加到專案。

還沒安裝應用程式?免費下載 AI Game Dev,支援 Windows、macOS 與 Linux。

從終端機

在你的專案資料夾中,使用 gamedev CLI:

gamedev pkg add aigd.model3d-trellis2-4b

需求

  • AI Game Dev 0.32.0-beta.6 或更新版本

進一步瞭解套件

安裝
gamedev pkg add aigd.model3d-trellis2-4b