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

# HeyGenImageToVideoNode - ComfyUI Built-in Node Documentation

> HeyGen Video 1.0을 사용하여 이미지를 동기화된 대화 및 사운드가 포함된 비디오로 애니메이션화합니다. 연결된 이미지는 첫 프레임으로 사용되며, 생성된 비디오는 해당 이미지의 가로세로 비율을 유지합니다. 프롬프트에 발화되는 대사를 포함하여 어떤 일이 일어나야 하는지 설명합니다. 이 노드는 이미지를 업로드하고, 비

HeyGen Video 1.0을 사용하여 이미지를 동기화된 대화 및 사운드가 포함된 비디오로 애니메이션화합니다. 연결된 이미지는 첫 프레임으로 사용되며, 생성된 비디오는 해당 이미지의 가로세로 비율을 유지합니다. 프롬프트에 발화되는 대사를 포함하여 어떤 일이 일어나야 하는지 설명합니다. 이 노드는 이미지를 업로드하고, 비디오 작업을 생성한 뒤 완료될 때까지 기다린 다음, 생성된 비디오를 반환합니다.

## 입력

| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
| - | - | - | - | - |
| `모델` | 생성에 사용되는 모델 버전입니다. (기본값: `"heygen-video-1"`) | DYNAMIC\_COMBO | 예 | `"heygen-video-1"` |
| `image` | 비디오의 첫 프레임입니다. 정확히 한 장의 이미지가 필요하며, 배치는 거부됩니다. 출력은 이 이미지의 가로세로 비율을 유지하므로 비디오의 형태를 변경하려면 이미지를 자르십시오. | IMAGE | 예 | 이미지 1장, 가로세로 비율 1:4\~4:1 |
| `prompt` | 비디오에서 일어나는 일에 대한 설명이며, 모든 대사를 포함합니다. (기본값: 빈 문자열) | STRING | 예 | 1\~32000자 |
| `duration` | 출력 비디오의 길이(초)입니다. (기본값: 5) | INT | 예 | 5\~15 |
| `resolution` | 출력 해상도입니다. (기본값: `"768p"`) | COMBO | 예 | `"768p"`<br />`"480p"` |
| `seed` | 생성을 위한 시드입니다. 동일한 시드를 사용하더라도 실행마다 결과가 달라질 수 있습니다. (기본값: 42) | INT | 예 | 0\~4294967295 |

### 매개변수 제약 조건

* **단일 이미지:** `image`에는 정확히 하나의 이미지가 포함되어야 합니다. 배치를 연결하면 오류가 발생합니다.
* **이미지 가로세로 비율:** 이미지는 높이의 4배보다 넓지 않아야 하며 너비의 4배보다 높지 않아야 합니다(1:4에서 4:1 사이). 그렇지 않으면 실행이 실패합니다.
* **프롬프트 필수:** 프롬프트에는 공백 문자가 아닌 문자가 최소 1개 포함되어야 하며, 문자 수는 최대 32000개여야 합니다.
* **시드:** 시드는 노드가 다시 실행되는지 여부만 결정합니다. 동일한 시드로도 결과를 재현할 수 없습니다.

## 출력

| 출력 이름 | 설명 | 데이터 타입 |
| - | - | - |
| `VIDEO` | 동기화된 대화와 사운드가 포함된 생성된 비디오이며, 입력 이미지의 가로세로 비율을 따릅니다. | VIDEO |

> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenImageToVideoNode/ko.md)

***

**Source fingerprint (SHA-256):** `1de530dcc98f2324f6ef4e2cfe309a717a12116382e9885aca14a8ae0be4de39`


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