> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# SAM 3D Body: extraer una malla 3D humana desde un video en ComfyUI

> Extrae una malla 3D del cuerpo humano desde un video con SAM 3D Body: pose y forma, expresiones faciales y video con la malla superpuesta.

**SAM 3D Body** es un modelo de código abierto que recupera una malla humana 3D de cuerpo completo a partir de un solo video. Combina seguimiento de video, detección de personas y predicción de malla para reconstruir el cuerpo humano con pose, forma y expresiones faciales, y luego renderiza el rig recuperado de vuelta sobre el video.

El flujo de trabajo es útil para prototipos de captura de movimiento, análisis biomecánico y previsualización de animación de personajes.

### SAM 3D Body: extracción de malla humana 3D desde video

Carga un video de una persona. Extrae una malla humana 3D de cuerpo completo con pose, forma y expresiones faciales, renderizada como un video con superposición.

![Vista previa del flujo de trabajo SAM 3D Body](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/utility_sam3d_body-1.webp)

> [!TIP]
>
> **Usuarios locales**
>
> Asegúrate de que tu ComfyUI esté actualizado.
>
> * [Descargar ComfyUI](https://www.comfy.org/download)
> * [Guía de actualización](https://docs.comfy.org/es/installation/update_comfyui.md)
>
> Los flujos de trabajo de esta guía se encuentran en las [Plantillas de flujos de trabajo](https://docs.comfy.org/es/interface/features/template.md).
> Si no los encuentras en las plantillas, es posible que tu ComfyUI esté desactualizado.
>
> Si faltan nodos al cargar un flujo de trabajo, estas son las posibles razones:
>
> 1. No estás usando la última versión de ComfyUI (versión nocturna)
> 2. Algunos nodos fallaron al importarse durante el inicio
>
> **Usuarios de Cloud**
>
> * [Cloud](https://cloud.comfy.org) se actualizará después del lanzamiento estable de ComfyUI.
>
> Por lo tanto, si notas que falta algún nodo central en este documento, puede deberse a que los nuevos nodos centrales aún no se han publicado en la última versión estable. Espera al próximo lanzamiento estable.

> **[Ejecutar en Comfy Cloud](https://cloud.comfy.org/?template=utility_sam3d_body\&utm_source=docs\&utm_medium=referral\&utm_campaign=sam3d-body)**
>
> Ejecuta este flujo de trabajo al instante en Comfy Cloud

> **[Descargar flujo de trabajo](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/utility_sam3d_body.json)**
>
> Descarga el JSON o busca "SAM 3D Body: 3D Human Mesh Extraction From Video" en la Biblioteca de plantillas

**Materiales de entrada**

Sube este archivo al nodo `LoadVideo`:

> **[woman\_holding\_water\_glass.mp4](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/woman_holding_water_glass.mp4)**
>
> nodo `LoadVideo` 85 · `woman_holding_water_glass.mp4`

## Cómo funciona

1. **Seguimiento de video**: SAM3 rastrea a la persona a lo largo de los fotogramas del video. El seguimiento es prácticamente obligatorio cuando aparecen varias personas en el clip, y en general mejora la precisión de la detección
2. **Detección de personas**: RT-DETR detecta las cajas delimitadoras de la persona, guiado por el prompt de texto (`person`)
3. **Predicción de la malla**: SAM 3D Body predice la malla 3D de cuerpo completo a partir de los fotogramas rastreados, con un FOV de cámara MoGe opcional para una alineación más precisa con el video fuente
4. **Expresiones faciales**: un paso basado en MediaPipe añade las expresiones faciales, que el modelo base no detecta
5. **Suavizado**: la secuencia de mallas se suaviza a lo largo del tiempo
6. **Renderizado**: se construye un archivo de pose (GLB), la malla se renderiza de vuelta sobre el video y luego se guarda como video de salida

## Pasos para ejecutar

1. **Carga un video**: usa el nodo `LoadVideo` para cargar un video de una persona
2. **Pon en cola el flujo de trabajo**: presiona Ctrl (Cmd en macOS) + Enter
3. **Espera el pipeline**: el seguimiento, la detección, la predicción de malla y el renderizado se ejecutan en secuencia
4. **Consulta el resultado**: revisa la malla en el nodo `Preview3D`. El video superpuesto se guarda en `ComfyUI/output/video/SAM3D_body/`

## Descargas de modelos

Descarga el modelo SAM 3D Body y los archivos necesarios. Colócalos en los subdirectorios correspondientes de `models/`.

> **[Checkpoint multiplex de SAM3](https://huggingface.co/Comfy-Org/sam3.1/blob/main/checkpoints/sam3.1_multiplex_fp16.safetensors)**
>
> sam3.1\_multiplex\_fp16.safetensors: checkpoint multiplex de SAM3 para el seguimiento en video

> **[Detección de SAM 3D Body](https://huggingface.co/Comfy-Org/sam-3d-body/blob/main/detection/sam_3d_body_dinov3_bf16.safetensors)**
>
> sam\_3d\_body\_dinov3\_bf16.safetensors: modelo de detección de SAM 3D Body (con backbone DINOv3)

> **[Geometría MoGe](https://huggingface.co/Comfy-Org/MoGe/blob/main/geometry_estimation/moge_2_vitl_normal_fp16.safetensors)**
>
> moge\_2\_vitl\_normal\_fp16.safetensors: estimación opcional del campo de visión de la cámara para la alineación

> **[Detector de personas RT-DETR](https://huggingface.co/Comfy-Org/SDPose/blob/main/diffusion_models/rt_detr_v4-x-hgnet_fp32.safetensors)**
>
> rt\_detr\_v4-x-hgnet\_fp32.safetensors: modelo de detección de personas RT-DETR

### Ubicación de almacenamiento de los modelos

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 checkpoints/
│   │      └── sam3.1_multiplex_fp16.safetensors
│   ├── 📂 detection/
│   │      └── sam_3d_body_dinov3_bf16.safetensors
│   ├── 📂 geometry_estimation/
│   │      └── moge_2_vitl_normal_fp16.safetensors
│   └── 📂 diffusion_models/
│          └── rt_detr_v4-x-hgnet_fp32.safetensors
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.