# Hunyuan3D-2.1 Shape (lokales 3D-Modell)

> Lokales Image-to-3D: Das Shape-Modell von Tencent Hunyuan3D-2.1 verwandelt ein Bild in ein hochwertiges untexturiertes 3D-Mesh (GLB) für Game-Props und Charaktere, auf deiner NVIDIA GPU mit 10 GB VRAM oder mehr. Läuft offline in der Local Python models runtime. Nicht lizenziert in der EU, im Vereinigten Königreich oder in Südkorea.

- Id: `aigd.model3d-hunyuan3d-2-1-shape`
- Quelle: Offiziell (First-Party `aigd.*`)
- Kategorie: 3D
- Herausgeber: AI Game Dev (`aigd`), verifiziert
- Neueste Version: 1.0.3 (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-hunyuan3d-2-1-shape

## Installieren

Mit der gamedev CLI im Projektordner:

```bash
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape
```

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

## Versionen

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

## Beschreibung

````markdown
# Hunyuan3D-2.1 Shape (`aigd.model3d-hunyuan3d-2-1-shape`)

Hunyuan3D-2.1 Shape verwandelt ein Bild auf deiner NVIDIA GPU (10 GB VRAM oder mehr) mit dem Shape-Modell von [Hunyuan3D-2.1](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1) von Tencent in eine hochwertige 3D-Form. Das Ergebnis ist ein untexturiertes GLB-Mesh. In AI Game Dev läuft es lokal über die **Local Python models runtime** (`aigd.python`). Es eignet sich für Entwickler, die detaillierte Basis-Meshes für Props und Charaktere wollen und sie an anderer Stelle texturieren möchten. **Es ist nicht lizenziert in der Europäischen Union, im Vereinigten Königreich oder in Südkorea.**

## Was du erstellen kannst

- Untexturierte 3D-Meshes von Props, Waffen, Möbeln, Kreaturen und Charakteren aus einem einzigen Konzeptbild.
- Basis-Meshes, die du später in deinen eigenen Tools oder mit anderen Paketen texturieren, retopologisieren oder riggen kannst.
- Schnelle 3D-Blockouts aus Concept Art.

## Beispielanfragen

- „Verwandle `Concepts/treasure_chest.png` mit Hunyuan3D in ein 3D-Modell.“
- „Erstelle eine 3D-Form aus diesem Schwertbild (transparenter Hintergrund).“
- „Generiere das Mesh für das Charakterkonzept, das ich gerade hinzugefügt habe.“

## Highlights

|  |  |
|---|---|
| Modell-ID | `aigd.model3d-hunyuan3d-2-1-shape.v1` |
| Operation | Bild zu 3D (ein Eingabebild) |
| Ausgabe | untexturiertes GLB |
| Schritte | Standardmäßig 50 |
| Läuft auf | NVIDIA GPU (CUDA) mit 10 GB VRAM oder mehr |
| Download | etwa 7.4 GB, plus die Python-Umgebung der Runtime beim ersten Laden |
| Lizenz | Tencent Hunyuan 3D 2.1 Community License: nicht in der EU, im Vereinigten Königreich oder in Südkorea; separate Lizenz bei über 1 Million monatlich aktiven Nutzern |

## Weitere lokale Image-to-3D-Modelle

- [TripoSG 1.5B](https://ai-game.dev/packages/aigd.model3d-triposg): untexturiert, 8 GB VRAM.
- [Step1X-3D Geometry](https://ai-game.dev/packages/aigd.model3d-step1x-3d-geometry): untexturiert, 16 GB VRAM, Apache-2.0.
- [TRELLIS.2 4B](https://ai-game.dev/packages/aigd.model3d-trellis2-4b) und [Pixal3D](https://ai-game.dev/packages/aigd.model3d-pixal3d): texturiertes GLB mit PBR-Materialien, 16 GB auf einer NVIDIA- oder Vulkan-GPU.

## So läuft es

**Das PBR-Texturmodell von Hunyuan3D-2.1 ist nicht enthalten.** Es benötigt benutzerdefinierte CUDA-Rasterizer, die auf deinem Computer kompiliert werden, und Blender als Python-Modul, was die Runtime der App nicht tut. Verwende ein Bild eines einzelnen Objekts mit transparentem Hintergrund. Der Checkpoint ist eine PyTorch-Datei, die nur als Tensoren geladen wird (`weights_only=True`), niemals als Code.

Die Ausgabe kann kleine abgetrennte Teile enthalten: Bei GPU-Prüfungen von TripoSG, Step1X-3D und Hunyuan3D machte die Hauptkomponente 97.5–99.2% der Flächen aus.

Dieses Paket enthält nur Daten. Es benötigt die **Local Python models runtime** (`aigd.python`), die beim ersten Laden eine private Python-Umgebung für das Modell einrichtet (ein paar GB PyTorch und Bibliotheken, siehe README jenes Pakets). Modelle laufen offline; ihre Gewichte stammen nur aus den unten aufgeführten Dateien, die nach deiner Bestätigung von Hugging Face heruntergeladen werden. AI Game Dev hostet sie nicht.

## Was heruntergeladen wird

Etwa 7.4 GB, festgelegt durch Hugging Face-Revision und sha256:

| Datei | Größe | Lizenz | Quelle |
|---|---|---|---|
| `hunyuan3d-dit-v2-1-config.yaml` | 0.00 GB | Tencent Hunyuan 3D 2.1 Community License | [Datei](https://huggingface.co/tencent/Hunyuan3D-2.1/resolve/0b94677654c57bb9a6b6845cd7b704ccf551d327/hunyuan3d-dit-v2-1/config.yaml) |
| `hunyuan3d-dit-v2-1-model.fp16.ckpt` | 7.37 GB | Tencent Hunyuan 3D 2.1 Community License | [Datei](https://huggingface.co/tencent/Hunyuan3D-2.1/resolve/0b94677654c57bb9a6b6845cd7b704ccf551d327/hunyuan3d-dit-v2-1/model.fp16.ckpt) |

Der Python-Code des Modells wird beim gepinnten Commit von GitHub heruntergeladen, jede Datei wird per sha256 geprüft.

## Lizenz

- **Gewichte und Inferenzcode: Tencent Hunyuan 3D 2.1 Community License** ([Lizenz](https://huggingface.co/tencent/Hunyuan3D-2.1/blob/0b94677654c57bb9a6b6845cd7b704ccf551d327/LICENSE), [Modellkarte](https://huggingface.co/tencent/Hunyuan3D-2.1/tree/0b94677654c57bb9a6b6845cd7b704ccf551d327); Code `hy3dshape/` von GitHub beim Commit [`82920d6`](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1/tree/82920d643c0dc2f7bfd7255f45f62d386edfe60c)).

Die Dateiköpfe von `hy3dshape` erwähnen eine „nicht kommerzielle“ Lizenz; die `LICENSE` des Repositorys (oben) ist die Community License, und diese ist maßgeblich.

Erforderliche Namensnennung (der Notice): "Tencent Hunyuan 3D 2.1 is licensed under the Tencent Hunyuan 3D 2.1 Community License Agreement, Copyright © 2025 Tencent. All Rights Reserved. The trademark rights of "Tencent Hunyuan" are owned by Tencent or its affiliate."

**Einschränkungen:**
- **Nicht lizenziert in der Europäischen Union, im Vereinigten Königreich oder in Südkorea.** Du darfst das Modell oder seine Ausgabe dort nicht verwenden.
- Ein Produkt oder eine Dienstleistung mit **mehr als 1 Million monatlich aktiven Nutzern** benötigt eine separate Lizenz von Tencent.
- Das Modell und seine Ausgabe dürfen nicht dazu verwendet werden, irgendein anderes KI-Modell zu verbessern.
- Es gilt die Acceptable Use Policy von Tencent.

Du bist dafür verantwortlich zu prüfen, ob deine Nutzung zulässig ist.
````
