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

# Video de Avatar HeyGen - ComfyUI Built-in Node Documentation

> Genera un video de presentador que habla a partir de un avatar de HeyGen.

Genera un video de presentador que habla a partir de un avatar de HeyGen. Este nodo crea un video de un avatar de IA que dice el texto que proporciones o que sincroniza los labios con tu propio audio, usando los motores de renderizado de HeyGen.

## Entradas

### Entradas comunes

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| - | - | - | - | - |
| `motor` | Motor de renderizado; cada opción lista solo los avatares que lo admiten. `"auto"` ofrece todos los avatares y elige su mejor motor (se prefiere Avatar IV). Avatar V es el de mayor fidelidad, Avatar III es el más económico. | DYNAMIC\_COMBO | Sí | `"auto"` `"avatar_iv"` `"avatar_iii"` `"avatar_v"` |
| `custom_avatar_id` | ID de apariencia de avatar de HeyGen opcional. Cuando se establece, anula el avatar seleccionado arriba. Se puede usar cualquiera de las más de 3000 apariencias públicas de HeyGen (o tus avatares privados). Predeterminado: `""`. | STRING | No | |
| `voz` | Controla el avatar con un guion de texto (texto a voz de HeyGen) o con tu propio audio. Nombre para mostrar: "speech source". | DYNAMIC\_COMBO | Sí | `"script"` `"audio"` |
| `resolución` | Resolución del video de salida. Predeterminado: `"1080p"`. | COMBO | No | `"720p"` `"1080p"` |
| `relación de aspecto` | Relación de aspecto de salida. `"auto"` sigue el metraje de origen del avatar. Predeterminado: `"auto"`. | COMBO | No | `"auto"` `"16:9"` `"9:16"` `"1:1"` `"4:5"` `"5:4"` |
| `color de fondo` | Color de fondo sólido opcional como código hexadecimal (p. ej. `"#00ff00"`). Déjalo vacío para usar el fondo propio del avatar. Si se proporciona, el valor debe comenzar con `#`. Predeterminado: `""`. | STRING | No | |
| `semilla` | No se envía a HeyGen; cámbialo para forzar una nueva ejecución. Predeterminado: `42`. | INT | No | Mín.: 0 Máx.: 2147483647 |

### Entradas de `auto`

Cuando `engine` es `"auto"`, está disponible el siguiente subparámetro:

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| - | - | - | - | - |
| `avatar` | Apariencia de avatar para presentar el video (seleccionada de la biblioteca pública de HeyGen). El mejor motor que admite la apariencia se elige automáticamente. | COMBO | Sí | Múltiples opciones disponibles |

### Entradas de `avatar_iv`

Cuando `engine` es `"avatar_iv"`, está disponible el siguiente subparámetro:

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| - | - | - | - | - |
| `avatar` | Apariencias de avatar que admiten el motor Avatar IV. | COMBO | Sí | Múltiples opciones disponibles |

### Entradas de `avatar_iii`

Cuando `engine` es `"avatar_iii"`, está disponible el siguiente subparámetro:

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| - | - | - | - | - |
| `avatar` | Apariencias de avatar que admiten el motor Avatar III. | COMBO | Sí | Múltiples opciones disponibles |

### Entradas de `avatar_v`

Cuando `engine` es `"avatar_v"`, está disponible el siguiente subparámetro:

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| - | - | - | - | - |
| `avatar` | Apariencias de avatar que admiten el motor Avatar V. | COMBO | Sí | Múltiples opciones disponibles |

### Entradas de `script`

Cuando `speech` es `"script"`, están disponibles los siguientes subparámetros:

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| - | - | - | - | - |
| `text` | Texto que el avatar debe decir (hasta 5000 caracteres). El habla generada debe durar al menos 1 segundo. Predeterminado: `""`. | STRING | Sí | Mín.: 1 carácter Máx.: 5000 caracteres |
| `voice` | Voz para el guion. La opción predeterminada usa la voz que HeyGen asignó al avatar. Se ignora si `custom_voice_id` está establecido. | COMBO | Sí | `"(avatar's default voice)"` Múltiples opciones de voz general disponibles |
| `custom_voice_id` | ID de voz de HeyGen opcional. Cuando se establece, anula la voz seleccionada arriba. Se puede usar cualquier voz de la biblioteca de HeyGen (más de 2000). Predeterminado: `""`. | STRING | No | |
| `voice_speed` | Multiplicador de velocidad del habla. Predeterminado: `1.0`. | FLOAT | No | Mín.: 0.5 Máx.: 1.5 Paso: 0.05 |

### Entradas de `audio`

Cuando `speech` es `"audio"`, está disponible el siguiente subparámetro:

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| - | - | - | - | - |
| `audio` | Audio para que el avatar sincronice los labios, hasta 10 minutos. | AUDIO | Sí | |

Nota: `engine` y `speech` son selectores que muestran diferentes subparámetros según el valor elegido. El selector `speech` tiene dos modos mutuamente excluyentes: en el modo `"script"`, `text` es obligatorio; si se proporciona `custom_voice_id`, anula `voice`. En el modo `"audio"`, el avatar sincroniza los labios con el clip de audio proporcionado. `background_color` debe ser un código de color hexadecimal que comience con `#` cuando se proporcione. Cuando se establece `custom_avatar_id`, anula la selección de `avatar`, y la apariencia de avatar seleccionada debe admitir el `engine` elegido; de lo contrario, se genera un error a menos que `engine` sea `"auto"`.

## Salidas

| Nombre de salida | Descripción | Tipo de datos |
| - | - | - |
| `VIDEO` | El video generado del presentador con avatar. | VIDEO |

> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenAvatarVideoNode/es.md)

***

**Source fingerprint (SHA-256):** `86dc799d3a8cf2666449b0d422853b12feffb81ce002f84594f9b925d58b522a`


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