Esta página foi traduzida automaticamente do inglês. Leia o original em inglês.

TRELLIS.2 4B (modelo 3D)

Oficial3DGPUv1.0.5aigd.model3d-trellis2-4b
Instalar Ainda sem o app? Baixe grátis
Ou pelo terminal
gamedev pkg add aigd.model3d-trellis2-4b
Roda no seu computador. Baixa o modelo uma vez e gera na GPU deste computador.

Visã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.png em 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 modeloaigd.model3d-trellis2-4b.f16
Operaçãoimagem para 3D (uma imagem PNG ou JPEG)
SaídaGLB texturizado com atlas UV e materiais PBR (texturas PNG)
Resoluções512, 1024 (padrão), 1536
Passos12 por padrão
Roda emGPU NVIDIA (CUDA) ou Vulkan com 16 GB de memória de vídeo
Download16,5 GB, 10 arquivos
LicençaMIT; 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.

BackendResoluçãoTempoPico de VRAM
CUDA51260.77 s7,321 MiB
CUDA1024290.88 s10,166 MiB
CUDA1536687.35 s14,857 MiB
Vulkan512147.04 s7,558 MiB
Vulkan1024710.54 s13,447 MiB

O que é baixado

Tudo de ilintar/trellis2-gguf na revisão a57397bd3d351599d9729fc144b3f87c3f87d65b (pesos F16, normas F32), verificado por sha256:

ArquivoO que éModelo de origemLicença
ss_flow, shape_flow_512, shape_flow_1024, tex_flow_512, tex_flow_1024os flow transformers de 1.3B dos três estágios (duas resoluções cada para forma e textura)microsoft/TRELLIS.2-4BMIT
shape_dec, tex_decdecodificadores de forma e texturamicrosoft/TRELLIS.2-4BMIT
ss_decdecodificador de estrutura esparsamicrosoft/TRELLIS-image-largeMIT
dinov3codificador de imagem DINOv3 ViT-L/16timm/vit_large_patch16_dinov3.lvd1689m (DINOv3 da Meta)DINOv3 License
birefnetremoção de fundoZhengPeng7/BiRefNetMIT

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-gguf declara 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ões de TRELLIS.2 4B (modelo 3D)
VersãoLançamentoRequer o app
1.0.5Mais recente0.32.0-beta.6 ou mais recente
1.0.40.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-4b

Requisitos

  • AI Game Dev 0.32.0-beta.6 ou mais recente

Mais sobre pacotes

Instalar
gamedev pkg add aigd.model3d-trellis2-4b