Diese Seite wurde maschinell aus dem Englischen übersetzt. Englisches Original lesen.

Hunyuan3D-2.1 Shape (lokales 3D-Modell)

Offiziell3DGPUv1.0.3aigd.model3d-hunyuan3d-2-1-shape
Oder im Terminal
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape
Läuft auf deinem Computer. Lädt ein Modell einmal herunter und generiert auf der GPU dieses Computers.

Übersicht

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.

NVIDIA 10 GB+

Hunyuan3D-2.1 Shape verwandelt ein Bild auf deiner NVIDIA GPU (10 GB VRAM oder mehr) mit dem Shape-Modell von 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-IDaigd.model3d-hunyuan3d-2-1-shape.v1
OperationBild zu 3D (ein Eingabebild)
Ausgabeuntexturiertes GLB
SchritteStandardmäßig 50
Läuft aufNVIDIA GPU (CUDA) mit 10 GB VRAM oder mehr
Downloadetwa 7.4 GB, plus die Python-Umgebung der Runtime beim ersten Laden
LizenzTencent 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

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:

DateiGrößeLizenzQuelle
hunyuan3d-dit-v2-1-config.yaml0.00 GBTencent Hunyuan 3D 2.1 Community LicenseDatei
hunyuan3d-dit-v2-1-model.fp16.ckpt7.37 GBTencent Hunyuan 3D 2.1 Community LicenseDatei

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, Modellkarte; Code hy3dshape/ von GitHub beim Commit 82920d6).

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.

Versionen

Releases von Hunyuan3D-2.1 Shape (lokales 3D-Modell)
VersionVeröffentlichtBenötigt die App
1.0.3Neueste0.32.0-beta.6 oder neuer
1.0.20.32.0-beta.6 oder neuer

Installieren

In der Desktop-App

Öffne das Fenster Packages (das Paket-Symbol in der Statusleiste), wähle Browse, suche aigd.model3d-hunyuan3d-2-1-shape und klicke auf Add to Project.

Noch keine App? Lade AI Game Dev kostenlos herunter für Windows, macOS oder Linux.

Im Terminal

Mit der gamedev CLI in deinem Projektordner:

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

Voraussetzungen

  • AI Game Dev 0.32.0-beta.6 oder neuer
  • Eine NVIDIA GPU mit mindestens 10 GB

Mehr zu Packages

Installieren
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape