TRELLIS.2 4B(3Dモデル)
gamedev pkg add aigd.model3d-trellis2-4b概要
ローカル画像→3D:MicrosoftのTRELLIS.2 4Bは、1枚の画像からテクスチャ付き3Dモデル(UVアトラスとPBRマテリアルを持つGLB)をゲームアセット向けに生成します。解像度は512、1024、1536。trellis.cppを使い、16 GBのビデオメモリを搭載したNVIDIAまたはVulkan GPUで動作します。MITライセンスですが、画像エンコーダにはMetaのDINOv3ライセンスが適用されます。
TRELLIS.2 4BはMicrosoftのTRELLIS.2画像→3Dモデルです。1枚の画像からテクスチャ付き3Dモデル、つまりUVアトラスとPBRマテリアル(ベースカラー、メタリック、ラフネス)を持つGLBを生成し、解像度1024で約30万面になります。AI Game Devでは、ローカル3D生成(aigd.trellis、trellis.cpp)を通じて、16 GBのビデオメモリを搭載したNVIDIA(CUDA)またはVulkan GPU上で動作します。クラウドサービスを使わずにコンセプトアートからテクスチャ付きアセットを得たい開発者に適しています。
作成できるもの
- 1枚の写真やコンセプト画像から、テクスチャ付きでPBR対応のプロップ、武器、家具、車両、キャラクターを生成できます。
- 普通の写真からのモデル生成:背景は自動的に除去されます(BiRefNet)。
- 解像度512の軽量なドラフトや、1536のより詳細なモデルも作成できます。
リクエスト例
- 「
Concepts/potion.pngをTRELLIS.2でテクスチャ付き3Dモデルに変換して」 - 「この古いラジオの写真から、まずは解像度512でテクスチャ付きGLBを作って。すぐに確認したいので」
- 「騎士のコンセプトから解像度1536で3Dモデルを生成して」
ハイライト
| モデルID | aigd.model3d-trellis2-4b.f16 |
| 操作 | 画像→3D(PNGまたはJPEG画像1枚) |
| 出力 | 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の比較
どちらもローカル3D生成で動作し、テクスチャ付き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を参照してください。
制限と実測値
- 入力: 1つのオブジェクトを写したPNGまたはJPEG画像1枚。背景は自動的に除去される(BiRefNet)ため、普通の写真で問題ありません。すでに透明部分がある画像はそれが維持されます。
- 出力: 自己完結型のGLB1つ(PNGテクスチャ)。
- 解像度: 512(軽量)、1024(デフォルト、512→1024のカスケード)、1536。
- 常にテクスチャ付き: ジオメトリのみの実行は提供されていません。trellis.cpp v0.8.1はテクスチャリング時にのみメッシュを簡略化するため、テクスチャなしではデコードされた生のメッシュ(実測1,567万面)が書き出され、アプリのGLB制限を超えてしまいます。実行時のフラグで簡略化する方法はほかにありません。
- ビット単位では同一にならない: 同じ画像、シード、設定でもビット単位で同一のGLBにはなりません。シード42でCUDAを2回実行したところ、どちらも有効な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ステップで1枚の画像を生成したときのエンドツーエンドの時間とデバイス全体のVRAMピークは次のとおりです。開始時のVRAM使用量は3,676~4,819 MiBでした。
| バックエンド | 解像度 | 時間 | VRAMピーク |
|---|---|---|---|
| CUDA | 512 | 60.77 s | 7,321 MiB |
| CUDA | 1024 | 290.88 s | 10,166 MiB |
| CUDA | 1536 | 687.35 s | 14,857 MiB |
| Vulkan | 512 | 147.04 s | 7,558 MiB |
| Vulkan | 1024 | 710.54 s | 13,447 MiB |
ダウンロードされる内容
すべてilintar/trellis2-ggufからリビジョンa57397bd3d351599d9729fc144b3f87c3f87d65bで取得します(F16の重み、F32のノルム)。sha256で検証済みです。
| ファイル | 内容 | ソースモデル | ライセンス |
|---|---|---|---|
ss_flow, shape_flow_512, shape_flow_1024, tex_flow_512, tex_flow_1024 | 3段階それぞれの1.3Bフロートランスフォーマー(シェイプとテクスチャ用に各2解像度) | microsoft/TRELLIS.2-4B | MIT |
shape_dec, tex_dec | シェイプとテクスチャのデコーダ | microsoft/TRELLIS.2-4B | MIT |
ss_dec | スパース構造デコーダ | microsoft/TRELLIS-image-large | MIT |
dinov3 | DINOv3 ViT-L/16 画像エンコーダ | timm/vit_large_patch16_dinov3.lvd1689m(MetaのDINOv3) | DINOv3 License |
birefnet | 背景除去 | ZhengPeng7/BiRefNet | MIT |
ライセンス
TRELLIS.2はMITです。商用利用が認められており、生成したものはあなたに帰属します(アプリはダウンロード前にライセンスへの同意を求めます。これは以下に示すDINOv3エンコーダの使用制限によるものです)。MITではないコンポーネントが1つあります。
- DINOv3画像エンコーダ(
dinov3.gguf)— MetaのDINOv3 License(2025年8月14日)。これは無料の、全世界規模の、ロイヤリティフリーのライセンスで、以下の条件のもとで商用利用を認めています。- エンコーダまたはその派生物を配布する場合は、DINOv3 Licenseのコピーを同梱し、関連するウェブサイト、ユーザーインターフェース、ブログ記事、aboutページ、製品ドキュメント上に"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がホストしているものではありません。モデルをダウンロードすると、これらのライセンスに同意したことになります。
バージョン
| バージョン | リリース日 | アプリが必要 |
|---|---|---|
| 1.0.5最新 | 0.32.0-beta.6 以降 | |
| 1.0.4 | 0.32.0-beta.6 以降 |
インストール
デスクトップアプリで
Packages ウィンドウを開き(ステータスバーのパッケージアイコン)、Browse を選んで aigd.model3d-trellis2-4b を検索し、Add to Project をクリックします。
アプリがまだない方は、Windows、macOS、Linux 用の AI Game Dev を無料でダウンロードしてください。
ターミナルから
gamedev CLI を使い、プロジェクトフォルダーで実行します。
gamedev pkg add aigd.model3d-trellis2-4b必要条件
- AI Game Dev 0.32.0-beta.6 以降
gamedev pkg add aigd.model3d-trellis2-4b