# Hunyuan3D-2.1 Shape (modelo 3D local)

> Imagen a 3D local: el modelo de forma de Tencent Hunyuan3D-2.1 convierte una imagen en una malla 3D (GLB) sin texturas de alta calidad para props y personajes de juego, en tu GPU NVIDIA con 10 GB de VRAM o más. Se ejecuta sin conexión en el runtime de modelos Python local. No tiene licencia en la UE, el Reino Unido ni Corea del Sur.

- Id: `aigd.model3d-hunyuan3d-2-1-shape`
- Origen: Oficial (propio `aigd.*`)
- Categoría: 3D
- Editor: AI Game Dev (`aigd`), verificado
- Última versión: 1.0.3 (publicado el 2026-11-22)
- Licencia: SEE LICENSE IN README.md
- Requiere la app AI Game Dev: `>=0.32.0-beta.6`
- Código nativo: no
- Valoración: aún sin valoraciones
- Página HTML: https://ai-game.dev/es/packages/aigd.model3d-hunyuan3d-2-1-shape

## Instalar

Con la CLI gamedev, en la carpeta del proyecto:

```bash
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape
```

En la app de escritorio: abre la ventana Packages (el icono de paquete en la barra de estado), selecciona **Browse**, busca `aigd.model3d-hunyuan3d-2-1-shape` y haz clic en **Add to Project**. Más: https://ai-game.dev/docs/wiki/app/packages

## Versiones

| Versión | Publicado | Requiere app | Notas |
|---|---|---|---|
| 1.0.3 | 2026-11-22 | `>=0.32.0-beta.6` | la más reciente |
| 1.0.2 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## Descripción

````markdown
# Hunyuan3D-2.1 Shape (`aigd.model3d-hunyuan3d-2-1-shape`)

Hunyuan3D-2.1 Shape convierte una imagen en una forma 3D de alta calidad en tu GPU NVIDIA (10 GB de VRAM o más), con el modelo de forma de [Hunyuan3D-2.1](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1) de Tencent. El resultado es una malla GLB sin texturas. En AI Game Dev se ejecuta localmente a través del **runtime de modelos Python local** (`aigd.python`). Está pensado para desarrolladores que quieren mallas base detalladas para props y personajes y las texturizarán en otra herramienta. **No tiene licencia en la Unión Europea, el Reino Unido ni Corea del Sur.**

## Qué puedes crear

- Mallas 3D sin texturas de props, armas, muebles, criaturas y personajes a partir de una sola imagen conceptual.
- Mallas base para texturizar, retopologizar o riggear más tarde en tus propias herramientas o con otros paquetes.
- Blockouts 3D rápidos a partir de concept art.

## Ejemplos de peticiones

- "Convierte `Concepts/treasure_chest.png` en un modelo 3D con Hunyuan3D."
- "Crea una forma 3D a partir de esta imagen de una espada (fondo transparente)."
- "Genera la malla del concepto de personaje que acabo de añadir."

## Aspectos destacados

|  |  |
|---|---|
| ID del modelo | `aigd.model3d-hunyuan3d-2-1-shape.v1` |
| Operación | imagen a 3D (una imagen de entrada) |
| Salida | GLB sin texturas |
| Pasos | 50 por defecto |
| Se ejecuta en | GPU NVIDIA (CUDA) con 10 GB de VRAM o más |
| Descarga | unos 7.4 GB, más el entorno de Python del runtime en la primera carga |
| Licencia | Tencent Hunyuan 3D 2.1 Community License: no en la UE, el Reino Unido ni Corea del Sur; licencia aparte por encima de 1 millón de usuarios activos mensuales |

## Otros modelos locales de imagen a 3D

- [TripoSG 1.5B](https://ai-game.dev/packages/aigd.model3d-triposg): sin texturas, 8 GB de VRAM.
- [Step1X-3D Geometry](https://ai-game.dev/packages/aigd.model3d-step1x-3d-geometry): sin texturas, 16 GB de VRAM, Apache-2.0.
- [TRELLIS.2 4B](https://ai-game.dev/packages/aigd.model3d-trellis2-4b) y [Pixal3D](https://ai-game.dev/packages/aigd.model3d-pixal3d): GLB con texturas y materiales PBR, 16 GB en una GPU NVIDIA o Vulkan.

## Cómo funciona

**El modelo de texturas PBR de Hunyuan3D-2.1 no está incluido.** Necesita rasterizadores CUDA personalizados compilados en tu equipo y Blender como módulo de Python, algo que el runtime de la app no hace. Usa una imagen de un solo objeto con fondo transparente. El checkpoint es un archivo PyTorch que se carga solo como tensores (`weights_only=True`), nunca como código.

La salida puede contener pequeñas partes separadas: en las comprobaciones en GPU de TripoSG, Step1X-3D y Hunyuan3D, el componente principal contenía el 97.5–99.2 % de las caras.

Este paquete solo contiene datos. Necesita el **runtime de modelos Python local** (`aigd.python`), que crea un entorno de Python privado para el modelo la primera vez que se carga (unos pocos GB de PyTorch y librerías; consulta el README de ese paquete). Los modelos se ejecutan sin conexión; sus pesos provienen únicamente de los archivos que se listan abajo, descargados de Hugging Face después de que lo confirmes. AI Game Dev no los aloja.

## Qué se descarga

Unos 7.4 GB, fijados por revisión de Hugging Face y sha256:

| Archivo | Tamaño | Licencia | Origen |
|---|---|---|---|
| `hunyuan3d-dit-v2-1-config.yaml` | 0.00 GB | Tencent Hunyuan 3D 2.1 Community License | [archivo](https://huggingface.co/tencent/Hunyuan3D-2.1/resolve/0b94677654c57bb9a6b6845cd7b704ccf551d327/hunyuan3d-dit-v2-1/config.yaml) |
| `hunyuan3d-dit-v2-1-model.fp16.ckpt` | 7.37 GB | Tencent Hunyuan 3D 2.1 Community License | [archivo](https://huggingface.co/tencent/Hunyuan3D-2.1/resolve/0b94677654c57bb9a6b6845cd7b704ccf551d327/hunyuan3d-dit-v2-1/model.fp16.ckpt) |

El código Python del modelo se descarga de GitHub en el commit fijado y cada archivo se verifica con sha256.

## Licencia

- **Pesos y código de inferencia: Tencent Hunyuan 3D 2.1 Community License** ([licencia](https://huggingface.co/tencent/Hunyuan3D-2.1/blob/0b94677654c57bb9a6b6845cd7b704ccf551d327/LICENSE), [ficha del modelo](https://huggingface.co/tencent/Hunyuan3D-2.1/tree/0b94677654c57bb9a6b6845cd7b704ccf551d327); código `hy3dshape/` de GitHub en el commit [`82920d6`](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1/tree/82920d643c0dc2f7bfd7255f45f62d386edfe60c)).

Las cabeceras de los archivos `hy3dshape` mencionan una licencia "no comercial"; el `LICENSE` del repositorio (arriba) es la Community License, y es la que se aplica.

Atribución obligatoria (el Aviso): "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."

**Restricciones:**
- **No tiene licencia en la Unión Europea, el Reino Unido ni Corea del Sur.** No puedes usar el modelo ni su salida en esos territorios.
- Un producto o servicio con **más de 1 millón de usuarios activos mensuales** necesita una licencia independiente de Tencent.
- El modelo y su salida no pueden utilizarse para mejorar ningún otro modelo de IA.
- Se aplica la Política de uso aceptable de Tencent.

Eres responsable de comprobar que tu uso está permitido.
````
