Step1X-3D Geometry (modelo 3D local)
gamedev pkg add aigd.model3d-step1x-3d-geometryVisão geral
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.
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 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.pngem 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: sem textura, 8 GB de VRAM.
- Hunyuan3D-2.1 Shape: sem textura, 10 GB de VRAM.
- TRELLIS.2 4B e 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 |
scheduler-scheduler_config.json | 0.00 GB | Apache-2.0 | arquivo |
transformer-config.json | 0.00 GB | Apache-2.0 | arquivo |
transformer-diffusion_pytorch_model.safetensors | 5.27 GB | Apache-2.0 | arquivo |
vae-config.json | 0.00 GB | Apache-2.0 | arquivo |
vae-diffusion_pytorch_model.safetensors | 0.77 GB | Apache-2.0 | arquivo |
visual_eature_extractor-preprocessor_config.json | 0.00 GB | Apache-2.0 | arquivo |
visual_encoder-config.json | 0.00 GB | Apache-2.0 | arquivo |
visual_encoder-diffusion_pytorch_model.safetensors | 1.22 GB | Apache-2.0 | arquivo |
dinov2-with-registers-large-config.json | 0.00 GB | Apache-2.0 | arquivo |
dinov2-with-registers-large-preprocessor_config.json | 0.00 GB | Apache-2.0 | arquivo |
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).
- Código de inferência (
step1x3d_geometry/, do GitHub no commitcb5ac94): Apache-2.0 (licença). - Arquivo de configuração do DINOv2 with registers (large): Apache-2.0, © Meta Platforms (card do modelo). Apenas seus
config.jsonepreprocessor_config.jsonsã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.
Versões
| Versão | Lançamento | Requer o app |
|---|---|---|
| 1.0.4Mais recente | 0.32.0-beta.6 ou mais recente | |
| 1.0.3 | 0.32.0-beta.6 ou mais recente |
Instalar
No app para desktop
Abra a janela Pacotes (o ícone de pacote na barra de status), selecione Explorar, pesquise aigd.model3d-step1x-3d-geometry e clique em Adicionar ao projeto.
Ainda sem o app? Baixe o AI Game Dev grátis para Windows, macOS ou Linux.
Pelo terminal
Com a CLI gamedev, na pasta do seu projeto:
gamedev pkg add aigd.model3d-step1x-3d-geometryRequisitos
- AI Game Dev 0.32.0-beta.6 ou mais recente
- Uma GPU NVIDIA com 16 GB ou mais
gamedev pkg add aigd.model3d-step1x-3d-geometry