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

# HeyGen Video 1.0 de referencia a vídeo - ComfyUI Built-in Node Documentation

> Genere un video con diálogo y sonido sincronizados a partir de un prompt de texto usando HeyGen Video 1.0

Genere un video con diálogo y sonido sincronizados a partir de un prompt de texto usando HeyGen Video 1.0, opcionalmente guiado por material de referencia conectado. Las imágenes de personas, productos o lugares, los videos para reutilizar y los clips de audio que proporcionan una voz pueden usarse como referencias. Mencione cada referencia en el prompt como @Image1, @Video1 o @Audio1, numeradas por tipo en el orden en que se conectan las entradas: estas etiquetas se reescriben a las etiquetas que HeyGen espera, y una etiqueta que apunte a una referencia que no está conectada genera un error. Sin ninguna imagen ni video de referencia, el nodo se ejecuta como generación de texto a video.

## Entradas

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| - | - | - | - | - |
| `modelo` | Versión del modelo utilizada para la generación. (predeterminado: `"heygen-video-1"`) | DYNAMIC\_COMBO | Sí | `"heygen-video-1"` |
| `prompt` | Descripción del video, incluido cualquier diálogo. Haga referencia a las referencias conectadas como @Image1, @Video1, @Audio1, numeradas por tipo en el orden de las entradas. (predeterminado: cadena vacía) | STRING | Sí | 1 a 32000 caracteres |
| `duration` | Duración del video de salida en segundos. (predeterminado: 5) | INT | Sí | 5 a 15 |
| `resolution` | Resolución de salida. 2k requiere una relación de aspecto de 16:9 o 9:16; `"auto"` solo funciona a 2k sin referencias. (predeterminado: `"768p"`) | COMBO | Sí | `"768p"` `"480p"` `"2k"` |
| `aspect_ratio` | Relación de aspecto de salida. `"auto"` es 16:9 cuando no hay referencias conectadas; de lo contrario, sigue la primera imagen de referencia o el primer video de referencia cuando no hay imágenes conectadas. (predeterminado: `"auto"`) | COMBO | Sí | `"auto"` `"16:9"` `"9:16"` `"1:1"` `"4:3"` `"3:4"` `"21:9"` |
| `seed` | Semilla para la generación. Los resultados aún pueden variar entre ejecuciones con la misma semilla. (predeterminado: 42) | INT | Sí | 0 a 4294967295 |
| `reference_images` | Ranura ampliable: imágenes de personas, productos o lugares para usar en el video (`image_1` ... `image_9`); haga referencia a ellas como @Image1, @Image2, ... Cada entrada debe contener exactamente una imagen, y cada imagen debe tener una relación de aspecto entre 1:4 y 4:1. | IMAGE | No | 0 a 9 imágenes |
| `reference_videos` | Ranura ampliable: videos para usar como referencias (`video_1` ... `video_3`); haga referencia a ellos como @Video1, @Video2, ... | VIDEO | No | 0 a 3 videos |
| `reference_audios` | Ranura ampliable: clips de audio, como una voz para un hablante (`audio_1` ... `audio_3`); haga referencia a ellos como @Audio1, @Audio2, ... Requiere al menos una imagen o un video de referencia. Una referencia de voz necesita unos segundos de habla limpia, y los clips de menos de aproximadamente 2 segundos suelen ignorarse. | AUDIO | No | 0 a 3 clips de audio |

### Restricciones de parámetros

* **Límite de referencias:** como máximo 12 referencias en total entre `reference_images`, `reference_videos` y `reference_audios`; conectar más genera un error.
* **El audio necesita imagen o video:** el audio de referencia se rechaza cuando no hay ninguna imagen de referencia ni ningún video de referencia conectado.
* **Reglas de las imágenes de referencia:** cada entrada de `reference_images` debe contener exactamente una imagen (se rechaza un lote), y cada imagen debe tener una relación de aspecto entre 1:4 y 4:1.
* **Etiquetas del prompt:** `@ImageN`, `@VideoN` y `@AudioN` se comparan sin distinguir mayúsculas y minúsculas. El número no debe superar la cantidad de referencias conectadas de ese tipo, y el prompt no debe estar vacío después de recortar los espacios en blanco.
* **Modo:** con al menos una imagen o un video de referencia, la solicitud es una ejecución de referencia a video; sin ninguna, es una ejecución simple de texto a video.
* **Resolución 2k:** `resolution` `"2k"` requiere `aspect_ratio` `"16:9"` o `"9:16"`; `"auto"` solo se acepta a 2k cuando no hay ninguna imagen ni ningún video de referencia conectado.
* **Semilla:** la semilla solo decide si el nodo se vuelve a ejecutar; los resultados no son reproducibles con la misma semilla.

## Salidas

| Nombre de salida | Descripción | Tipo de datos |
| - | - | - |
| `VIDEO` | El video generado con diálogo y sonido sincronizados. | 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/HeyGenReferenceToVideoNode/es.md)

***

**Source fingerprint (SHA-256):** `f3fae5dce59c90d65ad8eff2c992819f29a71e3a3e13fa91c1e7479a9cd6fcdc`


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