Hunyuan3D-2.1 Shape (modelo 3D local)
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shapeVisão geral
Imagem para 3D local: o modelo de forma do Hunyuan3D-2.1 da Tencent transforma uma imagem em uma malha 3D (GLB) sem textura de alta qualidade para props e personagens de jogos, na sua GPU NVIDIA com 10 GB de VRAM ou mais. Roda offline no runtime Local Python models. Sem licença na União Europeia, no Reino Unido ou na Coreia do Sul.
O Hunyuan3D-2.1 Shape transforma uma imagem em uma forma 3D de alta qualidade na sua GPU NVIDIA (10 GB de VRAM ou mais), com o modelo de forma do Hunyuan3D-2.1 da Tencent. O resultado é uma malha GLB sem textura. No AI Game Dev ele roda localmente pelo Local Python models runtime (aigd.python). Indicado para desenvolvedores que querem malhas base detalhadas para props e personagens e vão texturizá-las em outro lugar. Ele não tem licença na União Europeia, no Reino Unido nem na Coreia do Sul.
O que você pode criar
- Malhas 3D sem textura de props, armas, móveis, criaturas e personagens a partir de uma única imagem de conceito.
- Malhas base para texturizar, retopologizar ou rigar depois nas suas próprias ferramentas ou com outros pacotes.
- Blockouts 3D rápidos a partir de concept art.
Exemplos de solicitações
- "Transforme
Concepts/treasure_chest.pngem um modelo 3D com Hunyuan3D." - "Faça uma forma 3D desta imagem de espada (fundo transparente)."
- "Gere a malha do conceito de personagem que acabei de adicionar."
Destaques
| ID do modelo | aigd.model3d-hunyuan3d-2-1-shape.v1 |
| Operação | imagem para 3D (uma imagem de entrada) |
| Saída | GLB sem textura |
| Passos | 50 por padrão |
| Roda em | GPU NVIDIA (CUDA) com 10 GB de VRAM ou mais |
| Download | cerca de 7,4 GB, mais o ambiente Python do runtime no primeiro carregamento |
| Licença | Tencent Hunyuan 3D 2.1 Community License: fora da UE, do Reino Unido e da Coreia do Sul; licença separada acima de 1 milhão de usuários ativos mensais |
Outros modelos locais de imagem para 3D
- TripoSG 1.5B: sem textura, 8 GB de VRAM.
- Step1X-3D Geometry: sem textura, 16 GB de VRAM, Apache-2.0.
- TRELLIS.2 4B e Pixal3D: GLB com textura e materiais PBR, 16 GB em uma GPU NVIDIA ou Vulkan.
Como ele roda
O modelo de textura PBR do Hunyuan3D-2.1 não está incluído. Ele precisa de rasterizadores CUDA personalizados compilados no seu computador e do Blender como módulo Python, o que o runtime do app não faz. Use uma imagem de um único objeto com fundo transparente. O checkpoint é um arquivo PyTorch carregado apenas como tensores (weights_only=True), nunca como código.
A saída pode conter pequenas partes soltas: em verificações de 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 Local Python models runtime (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; os 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,4 GB, fixados por revisão e sha256 do Hugging Face:
| Arquivo | Tamanho | Licença | Origem |
|---|---|---|---|
hunyuan3d-dit-v2-1-config.yaml | 0.00 GB | Tencent Hunyuan 3D 2.1 Community License | arquivo |
hunyuan3d-dit-v2-1-model.fp16.ckpt | 7.37 GB | Tencent Hunyuan 3D 2.1 Community License | arquivo |
O código Python do modelo é baixado do GitHub no commit fixado, com cada arquivo verificado por sha256.
Licença
- Pesos e código de inferência: Tencent Hunyuan 3D 2.1 Community License (licença, model card; código
hy3dshape/do GitHub no commit82920d6).
Os cabeçalhos do arquivo hy3dshape mencionam uma licença "non-commercial"; o LICENSE do repositório (acima) é a Community License, e é ela que se aplica.
Atribuição obrigatória (o Notice): "Tencent Hunyuan 3D 2.1 is licensed under the Tencent Hunyuan 3D 2.1 Community License Agreement, Copyright © 2025 Tencent. All Rights Reserved. The trademark rights of "Tencent Hunyuan" are owned by Tencent or its affiliate."
Restrições:
- Sem licença na União Europeia, no Reino Unido ou na Coreia do Sul. Você não pode usar o modelo nem a saída dele nesses lugares.
- Um produto ou serviço com mais de 1 milhão de usuários ativos mensais precisa de uma licença separada da Tencent.
- O modelo e a saída dele não podem ser usados para melhorar qualquer outro modelo de IA.
- A Política de Uso Aceitável da Tencent se aplica.
Você é responsável por verificar se o seu uso é permitido.
Versões
| Versão | Lançamento | Requer o app |
|---|---|---|
| 1.0.3Mais recente | 0.32.0-beta.6 ou mais recente | |
| 1.0.2 | 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-hunyuan3d-2-1-shape 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-hunyuan3d-2-1-shapeRequisitos
- AI Game Dev 0.32.0-beta.6 ou mais recente
- Uma GPU NVIDIA com 10 GB ou mais
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape