# Step1X-3D Geometry (modelo 3D local)

> 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.

- Id: `aigd.model3d-step1x-3d-geometry`
- Origen: Oficial (propio `aigd.*`)
- Categoría: 3D
- Editor: AI Game Dev (`aigd`), verificado
- Última versión: 1.0.4 (publicado el 2026-11-22)
- Licencia: Apache-2.0
- Requiere la app AI Game Dev: `>=0.32.0-beta.6`
- Código nativo: no
- Valoración: aún sin valoraciones
- Página HTML: https://ai-game.dev/es/packages/aigd.model3d-step1x-3d-geometry

## Instalar

Con la CLI gamedev, en la carpeta del proyecto:

```bash
gamedev pkg add aigd.model3d-step1x-3d-geometry
```

En la app de escritorio: abre la ventana Packages (el icono de paquete en la barra de estado), selecciona **Browse**, busca `aigd.model3d-step1x-3d-geometry` y haz clic en **Add to Project**. Más: https://ai-game.dev/docs/wiki/app/packages

## Versiones

| Versión | Publicado | Requiere app | Notas |
|---|---|---|---|
| 1.0.4 | 2026-11-22 | `>=0.32.0-beta.6` | la más reciente |
| 1.0.3 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## Descripción

````markdown
# Step1X-3D Geometry 1.3B (`aigd.model3d-step1x-3d-geometry`)

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](https://github.com/stepfun-ai/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.png` en 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](https://ai-game.dev/packages/aigd.model3d-triposg): sin texturas, 8 GB de VRAM.
- [Hunyuan3D-2.1 Shape](https://ai-game.dev/packages/aigd.model3d-hunyuan3d-2-1-shape): sin texturas, 10 GB de VRAM.
- [TRELLIS.2 4B](https://ai-game.dev/packages/aigd.model3d-trellis2-4b) y [Pixal3D](https://ai-game.dev/packages/aigd.model3d-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](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/model_index.json) |
| `scheduler-scheduler_config.json` | 0.00 GB | Apache-2.0 | [archivo](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/scheduler/scheduler_config.json) |
| `transformer-config.json` | 0.00 GB | Apache-2.0 | [archivo](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/transformer/config.json) |
| `transformer-diffusion_pytorch_model.safetensors` | 5.27 GB | Apache-2.0 | [archivo](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/transformer/diffusion_pytorch_model.safetensors) |
| `vae-config.json` | 0.00 GB | Apache-2.0 | [archivo](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/vae/config.json) |
| `vae-diffusion_pytorch_model.safetensors` | 0.77 GB | Apache-2.0 | [archivo](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/vae/diffusion_pytorch_model.safetensors) |
| `visual_eature_extractor-preprocessor_config.json` | 0.00 GB | Apache-2.0 | [archivo](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/visual_eature_extractor/preprocessor_config.json) |
| `visual_encoder-config.json` | 0.00 GB | Apache-2.0 | [archivo](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/visual_encoder/config.json) |
| `visual_encoder-diffusion_pytorch_model.safetensors` | 1.22 GB | Apache-2.0 | [archivo](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/visual_encoder/diffusion_pytorch_model.safetensors) |
| `dinov2-with-registers-large-config.json` | 0.00 GB | Apache-2.0 | [archivo](https://huggingface.co/facebook/dinov2-with-registers-large/resolve/e4c89a4e05589de9b3e188688a303d0f3c04d0f3/config.json) |
| `dinov2-with-registers-large-preprocessor_config.json` | 0.00 GB | Apache-2.0 | [archivo](https://huggingface.co/facebook/dinov2-with-registers-large/resolve/e4c89a4e05589de9b3e188688a303d0f3c04d0f3/preprocessor_config.json) |

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](https://huggingface.co/stepfun-ai/Step1X-3D/tree/bf7084495b3a72222f36549b7942948aa4d9daa7)).
- **Código de inferencia** (`step1x3d_geometry/`, de GitHub en el commit [`cb5ac94`](https://github.com/stepfun-ai/Step1X-3D/tree/cb5ac944709c6c913109070c7b90c3447f57f3d4)): Apache-2.0 ([licencia](https://github.com/stepfun-ai/Step1X-3D/blob/cb5ac944709c6c913109070c7b90c3447f57f3d4/LICENSE)).
- **Archivo de configuración de DINOv2 with registers (large)**: Apache-2.0, © Meta Platforms ([ficha del modelo](https://huggingface.co/facebook/dinov2-with-registers-large/tree/e4c89a4e05589de9b3e188688a303d0f3c04d0f3)). Solo se descargan sus `config.json` y `preprocessor_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.
````
