Step1X-3D Geometry (lokales 3D-Modell)
gamedev pkg add aigd.model3d-step1x-3d-geometryÜbersicht
Lokales Image-to-3D: StepFuns Step1X-3D Geometry 1.3B verwandelt ein Bild in ein untexturiertes 3D-Mesh (GLB) für Game-Props und Charaktere – auf deiner NVIDIA GPU mit 16 GB VRAM. Läuft offline in der Local Python models runtime. Apache-2.0, kommerzielle Nutzung erlaubt.
Step1X-3D Geometry 1.3B verwandelt ein Bild auf deiner NVIDIA GPU (16 GB VRAM oder mehr) in eine 3D-Form – mit dem Geometriemodell von Step1X-3D von StepFun. Das Ergebnis ist ein untexturiertes GLB. In AI Game Dev läuft es lokal über die Local Python models runtime (aigd.python). Gewichte und Code stehen unter Apache-2.0, ohne territoriale Beschränkung und ohne Nutzerobergrenze, deshalb eignet es sich für kommerzielle Spiele überall.
Was du erstellen kannst
- Untexturierte Meshes von Props, Gebäuden, Fahrzeugen, Kreaturen und Charakteren aus einem einzigen Bild.
- Basis-Meshes, die du später texturieren, retopologisieren oder riggen kannst.
- 3D-Blockouts aus Concept Art.
Beispielanfragen
- „Verwandle
Concepts/barrel.pngmit Step1X-3D in ein 3D-Modell.“ - „Erstelle ein Mesh aus dem Drachen-Konzept.“
- „Generiere die 3D-Form aus diesem Haus-Bild.“
Highlights
| Modell-ID | aigd.model3d-step1x-3d-geometry.v1 |
| Vorgang | Bild zu 3D (ein Eingabebild mit transparentem Hintergrund) |
| Ausgabe | untexturiertes GLB, Flächen standardmäßig auf 200.000 reduziert |
| Schritte | standardmäßig 50 |
| Läuft auf | NVIDIA GPU (CUDA) mit 16 GB VRAM oder mehr |
| Download | etwa 7,2 GB, dazu die Python-Umgebung der Runtime beim ersten Laden |
| Lizenz | Apache-2.0, kommerzielle Nutzung erlaubt |
Weitere lokale Image-to-3D-Modelle
- TripoSG 1.5B: untexturiert, 8 GB VRAM.
- Hunyuan3D-2.1 Shape: untexturiert, 10 GB VRAM.
- TRELLIS.2 4B und Pixal3D: texturiertes GLB mit PBR-Materialien, 16 GB auf einer NVIDIA- oder Vulkan-GPU.
So läuft es
Das Texturmodell von Step1X-3D ist nicht enthalten. Es benötigt nvdiffrast (NVIDIA Source Code License, nicht kommerziell) und pytorch3d (keine vorgebauten Pakete), deshalb kann es nicht in der Runtime der App laufen. Verwende ein Bild mit einem einzelnen Objekt auf transparentem Hintergrund: Die App schneidet es auf das Objekt zu. Flächen werden standardmäßig auf 200.000 reduziert.
Die Ausgabe kann kleine abgetrennte Teile enthalten: In GPU-Prüfungen von TripoSG, Step1X-3D und Hunyuan3D umfasste die Hauptkomponente 97,5–99,2 % der Flächen.
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 (einige GB PyTorch und Bibliotheken, siehe README des Pakets). Modelle laufen offline; ihre Gewichte stammen ausschließlich 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,2 GB, festgelegt über Hugging Face Revision und sha256:
| Datei | Größe | Lizenz | Quelle |
|---|---|---|---|
model_index.json | 0.00 GB | Apache-2.0 | Datei |
scheduler-scheduler_config.json | 0.00 GB | Apache-2.0 | Datei |
transformer-config.json | 0.00 GB | Apache-2.0 | Datei |
transformer-diffusion_pytorch_model.safetensors | 5.27 GB | Apache-2.0 | Datei |
vae-config.json | 0.00 GB | Apache-2.0 | Datei |
vae-diffusion_pytorch_model.safetensors | 0.77 GB | Apache-2.0 | Datei |
visual_eature_extractor-preprocessor_config.json | 0.00 GB | Apache-2.0 | Datei |
visual_encoder-config.json | 0.00 GB | Apache-2.0 | Datei |
visual_encoder-diffusion_pytorch_model.safetensors | 1.22 GB | Apache-2.0 | Datei |
dinov2-with-registers-large-config.json | 0.00 GB | Apache-2.0 | Datei |
dinov2-with-registers-large-preprocessor_config.json | 0.00 GB | Apache-2.0 | Datei |
Der Python-Code des Modells wird vom festgeschriebenen Commit auf GitHub heruntergeladen, jede Datei per sha256 geprüft.
Lizenz
- Gewichte: Apache-2.0, © StepFun (Modellkarte).
- Inferenzcode (
step1x3d_geometry/, von GitHub beim Commitcb5ac94): Apache-2.0 (Lizenz). - Konfigurationsdatei von DINOv2 with registers (large): Apache-2.0, © Meta Platforms (Modellkarte). Davon werden nur
config.jsonundpreprocessor_config.jsonheruntergeladen; die Encoder-Gewichte sind Teil von Step1X-3D.
Erforderliche Namensnennung: "Step1X-3D © StepFun (Apache-2.0)".
Einschränkungen: Kommerzielle Nutzung ist erlaubt. Eine Weitergabe der Gewichte erfordert den Apache-2.0-Lizenztext und die Hinweise von StepFun.
Versionen
| Version | Veröffentlicht | Benötigt die App |
|---|---|---|
| 1.0.4Neueste | 0.32.0-beta.6 oder neuer | |
| 1.0.3 | 0.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-step1x-3d-geometry 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-step1x-3d-geometryVoraussetzungen
- AI Game Dev 0.32.0-beta.6 oder neuer
- Eine NVIDIA GPU mit mindestens 16 GB
gamedev pkg add aigd.model3d-step1x-3d-geometry