Video de Avatar HeyGen - ComfyUI Built-in Node Documentation

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

Source fingerprint (SHA-256): 86dc799d3a8cf2666449b0d422853b12feffb81ce002f84594f9b925d58b522a

​Entradas

​Entradas comunes

​Entradas de auto

​Entradas de avatar_iv

​Entradas de avatar_iii

​Entradas de avatar_v

​Entradas de script

​Entradas de audio

​Salidas