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

> Imagem para 3D local: o Step1X-3D Geometry 1.3B da StepFun transforma uma imagem em uma malha 3D sem textura (GLB) para props e personagens de jogos, na sua GPU NVIDIA com 16 GB de VRAM. Roda offline no runtime Local Python models. Apache-2.0, uso comercial permitido.

- Id: `aigd.model3d-step1x-3d-geometry`
- Origem: Oficial (de primeira parte `aigd.*`)
- Categoria: 3D
- Publicador: AI Game Dev (`aigd`), verificado
- Versão mais recente: 1.0.4 (publicado em 2026-11-22)
- Licença: Apache-2.0
- Requer o app AI Game Dev: `>=0.32.0-beta.6`
- Código nativo: não
- Avaliação: ainda sem avaliações
- Página HTML: https://ai-game.dev/pt-br/packages/aigd.model3d-step1x-3d-geometry

## Instalar

Com o CLI gamedev, na pasta do projeto:

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

No app desktop: abra a janela Packages (o ícone de pacote na barra de status), selecione **Browse**, busque `aigd.model3d-step1x-3d-geometry` e clique em **Add to Project**. Mais: https://ai-game.dev/docs/wiki/app/packages

## Versões

| Versão | Publicado | Requer o app | Observações |
|---|---|---|---|
| 1.0.4 | 2026-11-22 | `>=0.32.0-beta.6` | mais recente |
| 1.0.3 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## Descrição

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

O Step1X-3D Geometry 1.3B transforma uma imagem em uma forma 3D na sua GPU NVIDIA (16 GB de VRAM ou mais), com o modelo de geometria do [Step1X-3D](https://github.com/stepfun-ai/Step1X-3D) da StepFun. O resultado é um GLB sem textura. No AI Game Dev ele roda localmente pelo runtime **Local Python models** (`aigd.python`). Seus pesos e código são Apache-2.0, sem limite territorial ou de número de usuários, então serve para jogos comerciais em qualquer lugar.

## O que você pode criar

- Malhas sem textura de props, prédios, veículos, criaturas e personagens a partir de uma imagem.
- Malhas base para texturizar, retopologizar ou rigar depois.
- Blockouts 3D a partir de concept art.

## Exemplos de pedidos

- "Transforme `Concepts/barrel.png` em um modelo 3D com o Step1X-3D."
- "Crie uma malha do concept do dragão."
- "Gere a forma 3D da imagem desta casa."

## Destaques

|  |  |
|---|---|
| ID do modelo | `aigd.model3d-step1x-3d-geometry.v1` |
| Operação | imagem para 3D (uma imagem de entrada com fundo transparente) |
| Saída | GLB sem textura, faces reduzidas para 200,000 por padrão |
| Passos | 50 por padrão |
| Roda em | GPU NVIDIA (CUDA) com 16 GB de VRAM ou mais |
| Download | cerca de 7.2 GB, mais o ambiente Python do runtime no primeiro carregamento |
| Licença | Apache-2.0, uso comercial permitido |

## Outros modelos locais de imagem para 3D

- [TripoSG 1.5B](https://ai-game.dev/packages/aigd.model3d-triposg): sem textura, 8 GB de VRAM.
- [Hunyuan3D-2.1 Shape](https://ai-game.dev/packages/aigd.model3d-hunyuan3d-2-1-shape): sem textura, 10 GB de VRAM.
- [TRELLIS.2 4B](https://ai-game.dev/packages/aigd.model3d-trellis2-4b) e [Pixal3D](https://ai-game.dev/packages/aigd.model3d-pixal3d): GLB com textura e materiais PBR, 16 GB em uma GPU NVIDIA ou Vulkan.

## Como funciona

**O modelo de textura do Step1X-3D não está incluído.** Ele precisa de `nvdiffrast` (NVIDIA Source Code License, não comercial) e de `pytorch3d` (sem pacotes pré-compilados), então não pode rodar no runtime do app. Use uma imagem de um único objeto com fundo transparente: o app a recorta no objeto. As faces são reduzidas para 200,000 por padrão.

A saída pode conter pequenas partes soltas: nas verificações em GPU do TripoSG, do Step1X-3D e do Hunyuan3D, o componente principal concentrou 97.5–99.2% das faces.

Este pacote é apenas dados. Ele precisa do runtime **Local Python models** (`aigd.python`), que monta um ambiente Python privado para o modelo na primeira vez que ele carrega (alguns GB de PyTorch e bibliotecas, veja o README desse pacote). Os modelos rodam offline; seus pesos vêm apenas dos arquivos listados abaixo, baixados do Hugging Face depois que você confirma. O AI Game Dev não os hospeda.

## O que é baixado

Cerca de 7.2 GB, fixados por revisão do Hugging Face e sha256:

| Arquivo | Tamanho | Licença | Origem |
|---|---|---|---|
| `model_index.json` | 0.00 GB | Apache-2.0 | [arquivo](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 | [arquivo](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 | [arquivo](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 | [arquivo](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 | [arquivo](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 | [arquivo](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 | [arquivo](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 | [arquivo](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 | [arquivo](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 | [arquivo](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 | [arquivo](https://huggingface.co/facebook/dinov2-with-registers-large/resolve/e4c89a4e05589de9b3e188688a303d0f3c04d0f3/preprocessor_config.json) |

O código Python do modelo é baixado do GitHub no commit fixado, cada arquivo verificado por sha256.

## Licença

- **Pesos: Apache-2.0**, © StepFun ([card do modelo](https://huggingface.co/stepfun-ai/Step1X-3D/tree/bf7084495b3a72222f36549b7942948aa4d9daa7)).
- **Código de inferência** (`step1x3d_geometry/`, do GitHub no commit [`cb5ac94`](https://github.com/stepfun-ai/Step1X-3D/tree/cb5ac944709c6c913109070c7b90c3447f57f3d4)): Apache-2.0 ([licença](https://github.com/stepfun-ai/Step1X-3D/blob/cb5ac944709c6c913109070c7b90c3447f57f3d4/LICENSE)).
- **Arquivo de configuração do DINOv2 with registers (large)**: Apache-2.0, © Meta Platforms ([card do modelo](https://huggingface.co/facebook/dinov2-with-registers-large/tree/e4c89a4e05589de9b3e188688a303d0f3c04d0f3)). Apenas seus `config.json` e `preprocessor_config.json` são baixados; os pesos do encoder fazem parte do Step1X-3D.

Atribuição obrigatória: "Step1X-3D © StepFun (Apache-2.0)".

**Restrições:** o uso comercial é permitido. Para redistribuir os pesos é preciso incluir o texto da licença Apache-2.0 e os avisos da StepFun.
````
