TRELLIS.2 4B (modelo 3D)
gamedev pkg add aigd.model3d-trellis2-4bVisão geral
Geração 3D a partir de imagem local: o TRELLIS.2 4B da Microsoft transforma uma imagem em um modelo 3D texturizado (GLB com atlas UV e materiais PBR) para assets de jogo, na resolução 512, 1024 ou 1536. Roda com trellis.cpp em uma GPU NVIDIA ou Vulkan com 16 GB de memória de vídeo. MIT, com a licença DINOv3 da Meta para o codificador de imagem.
O TRELLIS.2 4B é o modelo image-to-3D TRELLIS.2 da Microsoft. Ele transforma uma imagem em um modelo 3D texturizado: um GLB com atlas UV e materiais PBR (cor base, metálico, rugosidade), cerca de 300.000 faces na resolução 1024. No AI Game Dev ele roda na sua GPU através de Geração 3D local (aigd.trellis, trellis.cpp), em GPUs NVIDIA (CUDA) ou Vulkan com 16 GB de memória de vídeo. É indicado para desenvolvedores que querem assets texturizados a partir de concept art sem usar um serviço de nuvem.
O que você pode criar
- Props, armas, móveis, veículos e personagens texturizados e prontos para PBR a partir de uma foto ou imagem de concept.
- Modelos a partir de fotos comuns: o fundo é removido automaticamente (BiRefNet).
- Rascunhos mais leves na resolução 512, ou modelos mais detalhados em 1536.
Exemplos de pedidos
- "Transforme
Concepts/potion.pngem um modelo 3D texturizado com o TRELLIS.2." - "Faça um GLB texturizado desta foto do meu rádio antigo na resolução 512 primeiro, para eu conferir rápido."
- "Gere um modelo 3D do concept do cavaleiro em 1536."
Destaques
| ID do modelo | aigd.model3d-trellis2-4b.f16 |
| Operação | imagem para 3D (uma imagem PNG ou JPEG) |
| Saída | GLB texturizado com atlas UV e materiais PBR (texturas PNG) |
| Resoluções | 512, 1024 (padrão), 1536 |
| Passos | 12 por padrão |
| Roda em | GPU NVIDIA (CUDA) ou Vulkan com 16 GB de memória de vídeo |
| Download | 16,5 GB, 10 arquivos |
| Licença | MIT; o codificador DINOv3 está sob a DINOv3 License da Meta |
TRELLIS.2 ou Pixal3D
Os dois rodam em Geração 3D local e geram GLBs texturizados.
- TRELLIS.2 4B (este pacote): o modelo base, com uma resolução 512 mais leve também.
- Pixal3D: o fine-tune do TRELLIS.2 da Tencent ARC que segue mais de perto a silhueta da foto; apenas resoluções 1024 e 1536. Ele compartilha 3,5 GB de arquivos com o TRELLIS.2, então os dois juntos somam cerca de 27 GB.
Para malhas sem textura em uma GPU NVIDIA, veja TripoSG, Hunyuan3D-2.1 Shape e Step1X-3D Geometry.
Limites e medições
- Entrada: uma imagem PNG ou JPEG de um único objeto. O fundo é removido automaticamente (BiRefNet), então uma foto comum funciona; uma imagem que já tem transparência a mantém.
- Saída: um GLB autocontido (texturas PNG).
- Resoluções: 512 (mais leve), 1024 (padrão, uma cascata 512→1024), 1536.
- Sempre texturizado: não há opção de executar apenas a geometria. O trellis.cpp v0.8.1 simplifica a malha somente durante a texturização, então, sem texturas, ele grava a malha bruta decodificada (15,67 milhões de faces medidas), o que ultrapassa os limites de GLB do app. Nenhuma flag de runtime a simplifica de outra forma.
- Não é bit-idêntico: a mesma imagem, semente e configurações não geram um GLB bit-idêntico. Duas execuções em CUDA com semente 42 geraram GLBs válidos, com geometria e hashes SHA-256 diferentes; a semente registrada identifica as configurações do pedido.
- Hardware: uma GPU NVIDIA (CUDA) ou Vulkan com 16 GB de memória de vídeo. O upstream afirma que a cascata 1024 roda em uma placa de 16 GB, e mediu 3:16–7:23 por modelo em uma RTX 5060 Ti 16 GB (6:09–12:39 em uma iGPU Radeon 8060S), incluindo o carregamento do modelo.
- Download: 16,5 GB, 10 arquivos.
No Windows com uma RTX 4090, uma imagem gerada com semente 42 e 12 passos deu estes tempos de ponta a ponta e picos de VRAM no dispositivo todo. O uso inicial de VRAM era de 3.676–4.819 MiB.
| Backend | Resolução | Tempo | Pico de VRAM |
|---|---|---|---|
| CUDA | 512 | 60.77 s | 7,321 MiB |
| CUDA | 1024 | 290.88 s | 10,166 MiB |
| CUDA | 1536 | 687.35 s | 14,857 MiB |
| Vulkan | 512 | 147.04 s | 7,558 MiB |
| Vulkan | 1024 | 710.54 s | 13,447 MiB |
O que é baixado
Tudo de ilintar/trellis2-gguf na revisão a57397bd3d351599d9729fc144b3f87c3f87d65b (pesos F16, normas F32), verificado por sha256:
| Arquivo | O que é | Modelo de origem | Licença |
|---|---|---|---|
ss_flow, shape_flow_512, shape_flow_1024, tex_flow_512, tex_flow_1024 | os flow transformers de 1.3B dos três estágios (duas resoluções cada para forma e textura) | microsoft/TRELLIS.2-4B | MIT |
shape_dec, tex_dec | decodificadores de forma e textura | microsoft/TRELLIS.2-4B | MIT |
ss_dec | decodificador de estrutura esparsa | microsoft/TRELLIS-image-large | MIT |
dinov3 | codificador de imagem DINOv3 ViT-L/16 | timm/vit_large_patch16_dinov3.lvd1689m (DINOv3 da Meta) | DINOv3 License |
birefnet | remoção de fundo | ZhengPeng7/BiRefNet | MIT |
Licença
O TRELLIS.2 é MIT: o uso comercial é permitido, e você é dono do que gera (o app pede que você aceite a licença antes do download, pelas restrições de uso do codificador DINOv3 descritas abaixo). Um componente não é MIT:
- Codificador de imagem DINOv3 (
dinov3.gguf) — a DINOv3 License da Meta (14 de agosto de 2025). É uma licença gratuita, mundial e livre de royalties que permite uso comercial, com estas condições:- Se você distribuir o codificador ou um derivado dele, inclua uma cópia da DINOv3 License e exiba com destaque "Built with DINOv3" em um site, interface de usuário, post de blog, página "sobre" ou documentação do produto relacionado.
- Nenhum uso para atividades sujeitas ao ITAR ou fins proibidos por controles comerciais: militar ou bélico, indústrias ou aplicações nucleares, espionagem, ou armas de fogo e armas ilegais. Você não pode ser alvo de sanções comerciais.
- Nada de engenharia reversa dos componentes subjacentes. A Meta pode encerrar a licença se você violá-la ou processar a Meta por causa dos materiais.
- O repositório GGUF
ilintar/trellis2-ggufdeclara a licença "other" e aponta para os modelos de origem; ele não acrescenta termos próprios. - A página de licença da Meta (14 de agosto de 2025, linkada acima) contém a obrigação "Built with DINOv3"; a cópia que acompanha o código do DINOv3 (19 de agosto de 2025) não a contém. Este pacote segue a mais restritiva.
Texto de atribuição obrigatório:
TRELLIS.2 © Microsoft Corporation (MIT). Built with DINOv3 (DINOv3 License, © Meta Platforms). BiRefNet © ZhengPeng7 (MIT).
Restrições, sem rodeios: a atribuição do DINOv3 e sua proibição de uso militar/armas/controles comerciais acima. Sem limite de receita, sem limite territorial, sem marca d'água.
Todos os arquivos são baixados do Hugging Face. O AI Game Dev não os hospeda. Você aceita essas licenças ao baixar o modelo.
Versões
| Versão | Lançamento | Requer o app |
|---|---|---|
| 1.0.5Mais recente | 0.32.0-beta.6 ou mais recente | |
| 1.0.4 | 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-trellis2-4b 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-trellis2-4bRequisitos
- AI Game Dev 0.32.0-beta.6 ou mais recente
gamedev pkg add aigd.model3d-trellis2-4b