# TRELLIS.2 4B (modelo 3D)

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

- Id: `aigd.model3d-trellis2-4b`
- Origem: Oficial (de primeira parte `aigd.*`)
- Categoria: 3D
- Publicador: AI Game Dev (`aigd`), verificado
- Versão mais recente: 1.0.5 (publicado em 2026-11-22)
- Licença: SEE LICENSE IN README.md
- 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-trellis2-4b

## Instalar

Com o CLI gamedev, na pasta do projeto:

```bash
gamedev pkg add aigd.model3d-trellis2-4b
```

No app desktop: abra a janela Packages (o ícone de pacote na barra de status), selecione **Browse**, busque `aigd.model3d-trellis2-4b` 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.5 | 2026-11-22 | `>=0.32.0-beta.6` | mais recente |
| 1.0.4 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## Descrição

````markdown
# TRELLIS.2 4B (`aigd.model3d-trellis2-4b`)

O TRELLIS.2 4B é o modelo image-to-3D [TRELLIS.2](https://huggingface.co/microsoft/TRELLIS.2-4B) 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](https://ai-game.dev/packages/aigd.trellis)** (`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 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](https://ai-game.dev/packages/aigd.trellis) e geram GLBs texturizados.

- **TRELLIS.2 4B** (este pacote): o modelo base, com uma resolução 512 mais leve também.
- **[Pixal3D](https://ai-game.dev/packages/aigd.model3d-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](https://ai-game.dev/packages/aigd.model3d-triposg), [Hunyuan3D-2.1 Shape](https://ai-game.dev/packages/aigd.model3d-hunyuan3d-2-1-shape) e [Step1X-3D Geometry](https://ai-game.dev/packages/aigd.model3d-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`](https://huggingface.co/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](https://huggingface.co/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](https://huggingface.co/microsoft/TRELLIS-image-large) | MIT |
| `dinov3` | codificador de imagem DINOv3 ViT-L/16 | [timm/vit_large_patch16_dinov3.lvd1689m](https://huggingface.co/timm/vit_large_patch16_dinov3.lvd1689m) (DINOv3 da Meta) | [DINOv3 License](https://ai.meta.com/resources/models-and-libraries/dinov3-license/) |
| `birefnet` | remoção de fundo | [ZhengPeng7/BiRefNet](https://huggingface.co/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](https://ai.meta.com/resources/models-and-libraries/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.
````
