# TRELLIS.2 4B（3Dモデル）

> ローカル画像→3D：MicrosoftのTRELLIS.2 4Bは、1枚の画像からテクスチャ付き3Dモデル（UVアトラスとPBRマテリアルを持つGLB）をゲームアセット向けに生成します。解像度は512、1024、1536。trellis.cppを使い、16 GBのビデオメモリを搭載したNVIDIAまたはVulkan GPUで動作します。MITライセンスですが、画像エンコーダにはMetaのDINOv3ライセンスが適用されます。

- ID: `aigd.model3d-trellis2-4b`
- ソース: 公式 (ファーストパーティ `aigd.*`)
- カテゴリ: 3D
- パブリッシャー: AI Game Dev (`aigd`), 確認済み
- 最新バージョン: 1.0.5 (公開日 2026-11-22)
- ライセンス: SEE LICENSE IN README.md
- AI Game Dev アプリが必要です: `>=0.32.0-beta.6`
- ネイティブコード: いいえ
- 評価: まだ評価はありません
- HTML ページ: https://ai-game.dev/ja/packages/aigd.model3d-trellis2-4b

## インストール

gamedev CLI を使用する場合は、プロジェクトフォルダで:

```bash
gamedev pkg add aigd.model3d-trellis2-4b
```

デスクトップアプリで: パッケージウィンドウ（ステータスバーのパッケージアイコン）を開き、**参照** を選択して `aigd.model3d-trellis2-4b` を検索し、**プロジェクトに追加** をクリックします。詳細: https://ai-game.dev/docs/wiki/app/packages

## バージョン

| バージョン | 公開日 | アプリが必要 | 備考 |
|---|---|---|---|
| 1.0.5 | 2026-11-22 | `>=0.32.0-beta.6` | 最新 |
| 1.0.4 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## 説明

````markdown
# TRELLIS.2 4B (`aigd.model3d-trellis2-4b`)

TRELLIS.2 4BはMicrosoftの[TRELLIS.2](https://huggingface.co/microsoft/TRELLIS.2-4B)画像→3Dモデルです。1枚の画像からテクスチャ付き3Dモデル、つまりUVアトラスとPBRマテリアル（ベースカラー、メタリック、ラフネス）を持つGLBを生成し、解像度1024で約30万面になります。AI Game Devでは、**[ローカル3D生成](https://ai-game.dev/packages/aigd.trellis)**（`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生成](https://ai-game.dev/packages/aigd.trellis)で動作し、テクスチャ付きGLBを生成します。

- **TRELLIS.2 4B**（このパッケージ）：ベースモデルで、より軽量な512解像度も利用できます。
- **[Pixal3D](https://ai-game.dev/packages/aigd.model3d-pixal3d)**：Tencent ARCによるTRELLIS.2のファインチューンで、写真のシルエットをより忠実に再現します。解像度は1024と1536のみです。TRELLIS.2と3.5 GBのファイルを共有するため、両方合わせると約27 GBになります。

NVIDIA GPUでテクスチャなしのメッシュが必要な場合は、[TripoSG](https://ai-game.dev/packages/aigd.model3d-triposg)、[Hunyuan3D-2.1 Shape](https://ai-game.dev/packages/aigd.model3d-hunyuan3d-2-1-shape)、[Step1X-3D Geometry](https://ai-game.dev/packages/aigd.model3d-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`](https://huggingface.co/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](https://huggingface.co/microsoft/TRELLIS.2-4B) | MIT |
| `shape_dec`, `tex_dec` | シェイプとテクスチャのデコーダ | microsoft/TRELLIS.2-4B | MIT |
| `ss_dec` | スパース構造デコーダ | [microsoft/TRELLIS-image-large](https://huggingface.co/microsoft/TRELLIS-image-large) | MIT |
| `dinov3` | DINOv3 ViT-L/16 画像エンコーダ | [timm/vit_large_patch16_dinov3.lvd1689m](https://huggingface.co/timm/vit_large_patch16_dinov3.lvd1689m)（MetaのDINOv3） | [DINOv3 License](https://ai.meta.com/resources/models-and-libraries/dinov3-license/) |
| `birefnet` | 背景除去 | [ZhengPeng7/BiRefNet](https://huggingface.co/ZhengPeng7/BiRefNet) | MIT |

## ライセンス

TRELLIS.2は**MIT**です。商用利用が認められており、生成したものはあなたに帰属します（アプリはダウンロード前にライセンスへの同意を求めます。これは以下に示すDINOv3エンコーダの使用制限によるものです）。MITではないコンポーネントが1つあります。

- **DINOv3画像エンコーダ**（`dinov3.gguf`）— Metaの[DINOv3 License](https://ai.meta.com/resources/models-and-libraries/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がホストしているものではありません。モデルをダウンロードすると、これらのライセンスに同意したことになります。
````
