SkinTokens(本機自動綁定)
gamedev pkg add aigd.model3d-skintokens總覽
本機自動綁定:VAST-AI 的 SkinTokens 能為角色或生物網格(GLB、OBJ 或 FBX)加上骨架與蒙皮權重,並輸出保留原始材質與 UV 的已綁定 GLB。可在 Asset Studio 中於你的 NVIDIA GPU 上執行,需 14 GB VRAM。MIT,允許商業使用。
SkinTokens 會在你的 NVIDIA GPU(14 GB 以上 VRAM)上,透過 VAST-AI 的 SkinTokens 為 3D 模型綁定。它會預測角色或生物網格的骨架與蒙皮權重,並寫回你的原始檔案,因此材質與 UV 都會保留。結果是一個已綁定的 GLB。在 AI Game Dev 中,它透過 Local Python models runtime(aigd.python)在本機執行。它適合需要在為生成的或手工製作的角色製作動畫之前,先取得初步骨架的開發者。
你可以製作的內容
- 從 GLB、OBJ 或 FBX 網格製作出已綁定的角色與生物,可直接在你的引擎或 DCC 工具中製作動畫。
- 為本機圖像轉 3D 模型所產生的網格提供初版骨架與蒙皮權重。
- 同一個網格可產生多個綁定候選:每次執行都會取樣新的骨架。
如何使用
綁定是在 Asset Studio 中執行,而不是透過聊天代理:
- 開啟 Asset Studio,選擇 3D → SkinTokens → Rig。
- 加入要綁定的網格:GLB、OBJ 或 FBX 檔案,例如
Assets/Models/goblin.glb。 - 檢查綁定後的 GLB。如果骨架不適合該模型,再執行一次:每次執行都會取樣新的骨架。
重點特色
| 模型 ID | aigd.model3d-skintokens.v1 |
| 操作 | 為 3D 模型綁定(單一輸入網格:GLB、OBJ 或 FBX) |
| 輸出 | 含骨架與蒙皮權重的已綁定 GLB;保留原始材質與 UV |
| 執行環境 | NVIDIA GPU(CUDA),需 14 GB 以上 VRAM |
| 下載 | 約 1.6 GB,首次載入時另需執行環境的 Python 環境(包含以 Python 模組形式提供的 Blender) |
| 授權條款 | MIT,允許將模型及其產生的綁定結果用於商業用途 |
要綁定的網格可以來自 TripoSG、Hunyuan3D-2.1 Shape、Step1X-3D Geometry、TRELLIS.2 或你自己的工具。
運作方式
此套件僅包含資料。它需要 Local Python models runtime(aigd.python)。首次載入時會建立專用的 Python 3.11 環境,內含 PyTorch 與以 Python 模組形式提供的 Blender(bpy 4.5 LTS,約 330 MB)。網格的讀取與寫入由 Blender 負責。不會安裝 FlashAttention:注意力運算使用 PyTorch 內建的 kernel。也不會安裝 Open3D:用於蒙皮權重平滑化的體素網格以 NumPy 建立,數學運算與 Open3D 相同。檢查點只以張量形式載入,絕不會以程式碼形式載入。模型離線執行;其權重僅來自下列檔案,並在你確認後從 Hugging Face 下載。AI Game Dev 並不托管這些檔案。
下載內容
約 1.6 GB,以 Hugging Face revision 與 sha256 鎖定:
| 檔案 | 大小 | 授權條款 | 來源 |
|---|---|---|---|
skin_vae_2_10_32768-last.ckpt | 0.49 GB | MIT | 檔案 |
articulation_xl_quantization_256_token_4-grpo_1400.ckpt | 1.13 GB | MIT | 檔案 |
Qwen3-0.6B-config.json | 0.00 GB | Apache-2.0 | 檔案 |
模型的 Python 程式碼(src/、configs/skeleton/)會從 GitHub 於 commit 273b691 下載,每個檔案都會以 sha256 檢查。
授權條款
- 權重與程式碼:MIT,© 2025 VAST-AI-Research(授權條款、模型卡)。
- Qwen3-0.6B 設定檔:Apache-2.0,© Alibaba Cloud(模型卡)。只會下載它的
config.json;語言模型的權重屬於 SkinTokens 的一部分。 - 以 Python 模組形式提供的 Blender(
bpy4.5.16):GPL-3.0-or-later,© Blender Foundation(PyPI)。執行環境會從 PyPI 將它安裝到模型的專屬環境中,應用程式的綁定處理程式會在其中匯入它來讀寫網格。AI Game Dev 不會隨附 bpy。 - 綁定處理程式(應用程式 Python 執行環境中的
skintokens/handler.py):GPL-3.0-or-later,因為它會匯入 bpy。它會以獨立程式的方式,在模型自己的 Python 工作行程中執行,應用程式會啟動該行程,並僅透過 stdio 上的 JSON 訊息與它通訊。其原始碼隨應用程式一同提供;請參閱THIRD_PARTY_NOTICES.md。
必要的署名:"SkinTokens © 2025 VAST-AI-Research (MIT)"。
限制:允許將模型及其製作的綁定結果用於商業用途。重新散布權重時必須附上 MIT 著作權聲明。
版本
| 版本 | 發布日期 | 需搭配應用程式 |
|---|---|---|
| 1.0.4最新 | 0.32.0-beta.6 或更新版本 | |
| 1.0.3 | 0.32.0-beta.6 或更新版本 |
安裝
在桌面應用程式中
開啟 套件 視窗(狀態列上的套件圖示),選擇 瀏覽,搜尋 aigd.model3d-skintokens,然後點選 加到專案。
還沒安裝應用程式?免費下載 AI Game Dev,支援 Windows、macOS 與 Linux。
從終端機
在你的專案資料夾中,使用 gamedev CLI:
gamedev pkg add aigd.model3d-skintokens需求
- AI Game Dev 0.32.0-beta.6 或更新版本
- NVIDIA GPU,14 GB 以上
gamedev pkg add aigd.model3d-skintokens