# TRELLIS.2 4B (3D-Modell)

> Lokales Image-to-3D: Microsofts TRELLIS.2 4B verwandelt ein Bild in ein texturiertes 3D-Modell (GLB mit UV-Atlas und PBR-Materialien) für Game-Assets, in Auflösung 512, 1024 oder 1536. Läuft mit trellis.cpp auf einer NVIDIA- oder Vulkan-GPU mit 16 GB Videospeicher. MIT, mit Metas DINOv3-Lizenz für den Bild-Encoder.

- Id: `aigd.model3d-trellis2-4b`
- Quelle: Offiziell (First-Party `aigd.*`)
- Kategorie: 3D
- Herausgeber: AI Game Dev (`aigd`), verifiziert
- Neueste Version: 1.0.5 (veröffentlicht am 2026-11-22)
- Lizenz: SEE LICENSE IN README.md
- Erfordert die AI Game Dev App: `>=0.32.0-beta.6`
- Nativer Code: nein
- Bewertung: noch nicht bewertet
- HTML-Seite: https://ai-game.dev/de/packages/aigd.model3d-trellis2-4b

## Installieren

Mit der gamedev CLI im Projektordner:

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

In der Desktop-App: Öffne das Fenster Packages (das Paket-Symbol in der Statusleiste), wähle **Browse**, suche nach `aigd.model3d-trellis2-4b` und klicke auf **Add to Project**. Mehr: https://ai-game.dev/docs/wiki/app/packages

## Versionen

| Version | Veröffentlicht | Erfordert App | Hinweise |
|---|---|---|---|
| 1.0.5 | 2026-11-22 | `>=0.32.0-beta.6` | neueste |
| 1.0.4 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## Beschreibung

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

TRELLIS.2 4B ist Microsofts Image-to-3D-Modell [TRELLIS.2](https://huggingface.co/microsoft/TRELLIS.2-4B). Es verwandelt ein Bild in ein texturiertes 3D-Modell: ein GLB mit UV-Atlas und PBR-Materialien (Grundfarbe, Metallic, Rauheit), etwa 300.000 Flächen bei Auflösung 1024. In AI Game Developer läuft es über **[Lokale 3D-Generierung](https://ai-game.dev/packages/aigd.trellis)** (`aigd.trellis`, trellis.cpp) auf deiner GPU, auf NVIDIA- (CUDA) oder Vulkan-GPUs mit 16 GB Videospeicher. Es eignet sich für Entwickler, die texturierte Assets aus Concept Art ohne Cloud-Dienst wollen.

## Was du erstellen kannst

- Texturierte, PBR-fertige Props, Waffen, Möbel, Fahrzeuge und Charaktere aus einem Foto oder Concept Image.
- Modelle aus einfachen Fotos: Der Hintergrund wird automatisch entfernt (BiRefNet).
- Leichtere Entwürfe bei Auflösung 512 oder detailliertere Modelle bei 1536.

## Beispielanfragen

- „Mach aus `Concepts/potion.png` mit TRELLIS.2 ein texturiertes 3D-Modell.“
- „Erstelle zuerst ein texturiertes GLB aus diesem Foto meines alten Radios bei Auflösung 512, damit ich es schnell prüfen kann.“
- „Generiere ein 3D-Modell des Ritter-Konzepts bei 1536.“

## Highlights

|  |  |
|---|---|
| Modell-ID | `aigd.model3d-trellis2-4b.f16` |
| Vorgang | Bild zu 3D (ein PNG- oder JPEG-Bild) |
| Ausgabe | texturiertes GLB mit UV-Atlas und PBR-Materialien (PNG-Texturen) |
| Auflösungen | 512, 1024 (Standard), 1536 |
| Schritte | standardmäßig 12 |
| Läuft auf | NVIDIA- (CUDA) oder Vulkan-GPU mit 16 GB Videospeicher |
| Download | 16,5 GB, 10 Dateien |
| Lizenz | MIT; der DINOv3-Encoder steht unter Metas DINOv3 License |

## TRELLIS.2 oder Pixal3D

Beide laufen über [Lokale 3D-Generierung](https://ai-game.dev/packages/aigd.trellis) und erzeugen texturierte GLBs.

- **TRELLIS.2 4B** (dieses Paket): das Basismodell, zusätzlich mit einer leichteren 512er-Auflösung.
- **[Pixal3D](https://ai-game.dev/packages/aigd.model3d-pixal3d)**: Tencent ARCs TRELLIS.2-Fine-Tune, der der Silhouette des Fotos genauer folgt; nur die Auflösungen 1024 und 1536. Er teilt sich 3,5 GB an Dateien mit TRELLIS.2, zusammen sind beide also etwa 27 GB.

Für untexturierte Meshes auf einer NVIDIA-GPU siehe [TripoSG](https://ai-game.dev/packages/aigd.model3d-triposg), [Hunyuan3D-2.1 Shape](https://ai-game.dev/packages/aigd.model3d-hunyuan3d-2-1-shape) und [Step1X-3D Geometry](https://ai-game.dev/packages/aigd.model3d-step1x-3d-geometry).

## Grenzen und Messungen

- **Eingabe:** ein PNG- oder JPEG-Bild eines Objekts. Der Hintergrund wird automatisch entfernt (BiRefNet), ein einfaches Foto funktioniert also; ein Bild, das bereits Transparenz hat, behält sie.
- **Ausgabe:** ein eigenständiges GLB (PNG-Texturen).
- **Auflösungen:** 512 (leichter), 1024 (Standard, eine 512→1024-Kaskade), 1536.
- **Immer texturiert:** Ein reiner Geometrie-Lauf wird nicht angeboten. trellis.cpp v0.8.1 vereinfacht das Mesh nur während der Texturierung, ohne Texturen schreibt es also das rohe dekodierte Mesh (gemessen 15,67 Millionen Flächen), das über den GLB-Grenzen der App liegt. Kein Laufzeit-Flag vereinfacht es anderweitig.
- **Nicht bit-identisch:** Dasselbe Bild, derselbe Seed und dieselben Einstellungen ergeben kein bit-identisches GLB. Zwei CUDA-Läufe mit Seed 42 ergaben beide gültige GLBs mit unterschiedlicher Geometrie und unterschiedlichen SHA-256-Hashes; der aufgezeichnete Seed kennzeichnet die Anfrage-Einstellungen.
- **Hardware:** eine NVIDIA- (CUDA) oder Vulkan-GPU mit **16 GB** Videospeicher. Upstream gibt an, dass die 1024er-Kaskade auf einer 16-GB-Karte läuft, und hat 3:16–7:23 pro Modell auf einer RTX 5060 Ti 16 GB gemessen (6:09–12:39 auf einer Radeon 8060S iGPU) inklusive Modell-Ladezeit.
- **Download:** 16,5 GB, 10 Dateien.

Unter Windows mit einer RTX 4090 ergab ein Bild, generiert mit Seed 42 und 12 Schritten, diese End-to-End-Zeiten und geräteweiten VRAM-Spitzen. Die VRAM-Auslastung zu Beginn lag bei 3.676–4.819 MiB.

| Backend | Auflösung | Zeit | Spitzen-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 |

## Was heruntergeladen wird

Alles von [`ilintar/trellis2-gguf`](https://huggingface.co/ilintar/trellis2-gguf) bei Revision `a57397bd3d351599d9729fc144b3f87c3f87d65b` (F16-Gewichte, F32-Normen), per sha256 geprüft:

| Datei | Was es ist | Quellmodell | Lizenz |
|---|---|---|---|
| `ss_flow`, `shape_flow_512`, `shape_flow_1024`, `tex_flow_512`, `tex_flow_1024` | die 1.3B-Flow-Transformer der drei Stufen (je zwei Auflösungen für Form und Textur) | [microsoft/TRELLIS.2-4B](https://huggingface.co/microsoft/TRELLIS.2-4B) | MIT |
| `shape_dec`, `tex_dec` | Form- und Textur-Decoder | microsoft/TRELLIS.2-4B | MIT |
| `ss_dec` | Sparse-Struktur-Decoder | [microsoft/TRELLIS-image-large](https://huggingface.co/microsoft/TRELLIS-image-large) | MIT |
| `dinov3` | DINOv3 ViT-L/16 Bild-Encoder | [timm/vit_large_patch16_dinov3.lvd1689m](https://huggingface.co/timm/vit_large_patch16_dinov3.lvd1689m) (Metas DINOv3) | [DINOv3 License](https://ai.meta.com/resources/models-and-libraries/dinov3-license/) |
| `birefnet` | Hintergrundentfernung | [ZhengPeng7/BiRefNet](https://huggingface.co/ZhengPeng7/BiRefNet) | MIT |

## Lizenz

TRELLIS.2 ist **MIT**: kommerzielle Nutzung ist erlaubt, und dir gehört, was du generierst (die App bittet dich, die Lizenz vor dem Download zu akzeptieren, wegen der Nutzungsbeschränkungen des DINOv3-Encoders weiter unten). Eine Komponente ist nicht MIT:

- **DINOv3 Bild-Encoder** (`dinov3.gguf`) — Metas [DINOv3 License](https://ai.meta.com/resources/models-and-libraries/dinov3-license/) (14. August 2025). Sie ist eine kostenlose, weltweite, gebührenfreie Lizenz, die kommerzielle Nutzung erlaubt, unter diesen Bedingungen:
  - Wenn du den Encoder oder ein Derivat davon verbreitest, füge eine Kopie der DINOv3 License bei und **zeige "Built with DINOv3" deutlich sichtbar** auf einer zugehörigen Website, Benutzeroberfläche, einem Blogbeitrag, einer About-Seite oder Produktdokumentation.
  - Keine Nutzung für Aktivitäten, die ITAR unterliegen, oder Endverwendungen, die durch Handelskontrollen untersagt sind: Militär oder Kriegführung, Nuklearindustrie oder -anwendungen, Spionage oder Schusswaffen und illegale Waffen. Du darfst nicht Ziel von Handelssanktionen sein.
  - Kein Reverse Engineering der zugrunde liegenden Komponenten. Meta kann die Lizenz beenden, wenn du sie verletzt oder Meta wegen der Materialien verklagst.
- Das GGUF-Repo `ilintar/trellis2-gguf` deklariert die Lizenz „other“ und verweist auf die Quellmodelle; es fügt keine eigenen Bedingungen hinzu.
- Metas Lizenzseite (14. August 2025, oben verlinkt) enthält die Pflicht aus "Built with DINOv3"; die mit dem DINOv3-Code ausgelieferte Kopie (19. August 2025) nicht. Dieses Paket folgt der strengeren Variante.

Erforderlicher Attributionshinweis:

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

Die Beschränkungen, klar gesagt: die DINOv3-Attribution und das oben genannte Verbot von Militär, Waffen und Handelskontrollen. Keine Umsatzobergrenze, keine territoriale Beschränkung, kein Wasserzeichen.

Alle Dateien werden von Hugging Face heruntergeladen. AI Game Dev hostet sie nicht. Mit dem Download des Modells akzeptierst du diese Lizenzen.
````
