Step1X-3D Geometry (modelo 3D local)
gamedev pkg add aigd.model3d-step1x-3d-geometryResumen
Imagen a 3D local: Step1X-3D Geometry 1.3B de StepFun convierte una sola imagen en una malla 3D sin texturas (GLB) para props y personajes de juego, en tu GPU NVIDIA con 16 GB de VRAM. Se ejecuta sin conexión en el Local Python models runtime. Apache-2.0, se permite el uso comercial.
Step1X-3D Geometry 1.3B convierte una imagen en una forma 3D en tu GPU NVIDIA (16 GB de VRAM o más), con el modelo de geometría de Step1X-3D de StepFun. El resultado es un GLB sin texturas. En AI Game Dev se ejecuta localmente mediante el Local Python models runtime (aigd.python). Sus pesos y su código son Apache-2.0, sin límite territorial ni tope de usuarios, así que sirve para juegos comerciales en cualquier lugar.
Qué puedes crear
- Mallas sin texturas de props, edificios, vehículos, criaturas y personajes a partir de una sola imagen.
- Mallas base para texturizar, retopologizar o riggear más adelante.
- Blockouts 3D a partir de concept art.
Ejemplos de peticiones
- "Convierte
Concepts/barrel.pngen un modelo 3D con Step1X-3D." - "Crea una malla del concepto del dragón."
- "Genera la forma 3D de esta imagen de casa."
Aspectos destacados
| ID del modelo | aigd.model3d-step1x-3d-geometry.v1 |
| Operación | imagen a 3D (una imagen de entrada con fondo transparente) |
| Salida | GLB sin texturas, caras reducidas a 200,000 por defecto |
| Pasos | 50 por defecto |
| Se ejecuta en | GPU NVIDIA (CUDA) con 16 GB de VRAM o más |
| Descarga | unos 7.2 GB, más el entorno Python del runtime en la primera carga |
| Licencia | Apache-2.0, se permite el uso comercial |
Otros modelos locales de imagen a 3D
- TripoSG 1.5B: sin texturas, 8 GB de VRAM.
- Hunyuan3D-2.1 Shape: sin texturas, 10 GB de VRAM.
- TRELLIS.2 4B y Pixal3D: GLB con texturas y materiales PBR, 16 GB en una GPU NVIDIA o Vulkan.
Cómo funciona
El modelo de texturas de Step1X-3D no está incluido. Necesita nvdiffrast (NVIDIA Source Code License, no comercial) y pytorch3d (sin paquetes precompilados), así que no puede ejecutarse en el runtime de la app. Usa una imagen de un solo objeto con fondo transparente: la app la recorta al objeto. Las caras se reducen a 200,000 por defecto.
La salida puede contener pequeñas partes separadas: en las comprobaciones en GPU de TripoSG, Step1X-3D y Hunyuan3D, el componente principal contenía el 97.5–99.2% de las caras.
Este paquete solo contiene datos. Necesita el Local Python models runtime (aigd.python), que crea un entorno Python privado para el modelo la primera vez que se carga (unos pocos GB de PyTorch y librerías; consulta el README de ese paquete). Los modelos se ejecutan sin conexión; sus pesos provienen únicamente de los archivos que se indican abajo, descargados de Hugging Face después de que lo confirmes. AI Game Dev no los aloja.
Qué se descarga
Unos 7.2 GB, fijados por revisión de Hugging Face y sha256:
| Archivo | Tamaño | Licencia | Origen |
|---|---|---|---|
model_index.json | 0.00 GB | Apache-2.0 | archivo |
scheduler-scheduler_config.json | 0.00 GB | Apache-2.0 | archivo |
transformer-config.json | 0.00 GB | Apache-2.0 | archivo |
transformer-diffusion_pytorch_model.safetensors | 5.27 GB | Apache-2.0 | archivo |
vae-config.json | 0.00 GB | Apache-2.0 | archivo |
vae-diffusion_pytorch_model.safetensors | 0.77 GB | Apache-2.0 | archivo |
visual_eature_extractor-preprocessor_config.json | 0.00 GB | Apache-2.0 | archivo |
visual_encoder-config.json | 0.00 GB | Apache-2.0 | archivo |
visual_encoder-diffusion_pytorch_model.safetensors | 1.22 GB | Apache-2.0 | archivo |
dinov2-with-registers-large-config.json | 0.00 GB | Apache-2.0 | archivo |
dinov2-with-registers-large-preprocessor_config.json | 0.00 GB | Apache-2.0 | archivo |
El código Python del modelo se descarga de GitHub en el commit fijado y cada archivo se verifica con sha256.
Licencia
- Pesos: Apache-2.0, © StepFun (ficha del modelo).
- Código de inferencia (
step1x3d_geometry/, de GitHub en el commitcb5ac94): Apache-2.0 (licencia). - Archivo de configuración de DINOv2 with registers (large): Apache-2.0, © Meta Platforms (ficha del modelo). Solo se descargan sus
config.jsonypreprocessor_config.json; los pesos del codificador forman parte de Step1X-3D.
Atribución obligatoria: "Step1X-3D © StepFun (Apache-2.0)".
Restricciones: se permite el uso comercial. Redistribuir los pesos requiere el texto de la licencia Apache-2.0 y los avisos de StepFun.
Versiones
| Versión | Publicada | Requiere la aplicación |
|---|---|---|
| 1.0.4Última | 0.32.0-beta.6 o posterior | |
| 1.0.3 | 0.32.0-beta.6 o posterior |
Instalar
En la app de escritorio
Abre la ventana Paquetes (el icono de paquete en la barra de estado), selecciona Explorar, busca aigd.model3d-step1x-3d-geometry y haz clic en Añadir al proyecto.
¿Aún no tienes la app? Descarga AI Game Dev gratis para Windows, macOS o Linux.
Desde el terminal
Con la CLI gamedev, en la carpeta de tu proyecto:
gamedev pkg add aigd.model3d-step1x-3d-geometryRequisitos
- AI Game Dev 0.32.0-beta.6 o posterior
- Una GPU NVIDIA con 16 GB o más
gamedev pkg add aigd.model3d-step1x-3d-geometry