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

# HeyGenAvatarVideoNode - ComfyUI Built-in Node Documentation

> Complete documentation for the HeyGenAvatarVideoNode node in ComfyUI. Learn its inputs, outputs, parameters and usage.

HeyGen 아바타로 말하는 프레젠터 동영상을 생성합니다. 이 노드는 HeyGen의 렌더링 엔진을 사용하여 제공된 텍스트를 말하는 AI 아바타 동영상이나 사용자 오디오에 립싱크하는 동영상을 만듭니다.

## 입력

| 매개변수         | 설명                                                                                                                                           | 데이터 타입 | 필수  | 범위                                                                          |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------- | ------ | --- | --------------------------------------------------------------------------- |
| `엔진`         | 렌더링 엔진입니다. 각 선택지는 이를 지원하는 아바타만 표시합니다. 'auto'는 모든 아바타를 제공하고 가장 적합한 엔진을 선택합니다(Avatar IV 선호). Avatar V는 가장 높은 충실도를 제공하며, Avatar III는 가장 경제적입니다. | COMBO  | 예   | `"auto"`<br />`"avatar_iv"`<br />`"avatar_iii"`<br />`"avatar_v"`           |
| `커스텀 아바타 ID` | 선택적 HeyGen 아바타 룩 ID입니다. 설정 시 위에서 선택한 아바타를 재정의합니다. HeyGen의 3000개 이상 공개 룩(또는 개인 아바타)을 사용할 수 있습니다.                                              | STRING | 아니요 |                                                                             |
| `음성`         | 텍스트 스크립트(HeyGen 텍스트 음성 변환) 또는 사용자 오디오로 아바타를 구동합니다.                                                                                           | COMBO  | 예   | `"script"`<br />`"audio"`                                                   |
| `해상도`        | 출력 동영상 해상도입니다(기본값: "1080p").                                                                                                                 | COMBO  | 아니요 | `"720p"`<br />`"1080p"`                                                     |
| `화면 비율`      | 출력 화면 비율입니다. 'auto'는 아바타의 원본 영상을 따릅니다(기본값: "auto").                                                                                          | COMBO  | 아니요 | `"auto"`<br />`"16:9"`<br />`"9:16"`<br />`"1:1"`<br />`"4:5"`<br />`"5:4"` |
| `배경 색상`      | 선택적 단색 배경색으로 16진수 코드입니다(예: '#00ff00'). 아바타 자체 배경을 사용하려면 비워 둡니다.                                                                              | STRING | 아니요 |                                                                             |
| `시드`         | HeyGen으로 전송되지 않습니다. 변경하여 재실행을 강제합니다(기본값: 42).                                                                                                | INT    | 아니요 | 최소: 0<br />최대: 2147483647                                                   |

`speech`가 `"script"`로 설정된 경우 다음 하위 매개변수를 사용할 수 있습니다:

| 매개변수              | 설명                                                                                       | 데이터 타입 | 필수  | 범위                                 |
| ----------------- | ---------------------------------------------------------------------------------------- | ------ | --- | ---------------------------------- |
| `text`            | 아바타가 말할 텍스트입니다(최대 5000자). 생성된 음성은 최소 1초 이상이어야 합니다.                                       | STRING | 예   |                                    |
| `voice`           | 스크립트의 음성입니다. 기본 옵션은 HeyGen이 아바타에 할당한 음성을 사용합니다.                                          | COMBO  | 예   | 여러 옵션 사용 가능                        |
| `custom_voice_id` | 선택적 HeyGen 음성 ID입니다. 설정 시 위에서 선택한 음성을 재정의합니다. HeyGen 라이브러리(2000개 이상)의 모든 음성을 사용할 수 있습니다. | STRING | 아니요 |                                    |
| `voice_speed`     | 음성 속도 배수입니다(기본값: 1.0).                                                                   | FLOAT  | 아니요 | 최소: 0.5<br />최대: 1.5<br />단계: 0.05 |

`speech`가 `"audio"`로 설정된 경우 다음 하위 매개변수를 사용할 수 있습니다:

| 매개변수    | 설명                        | 데이터 타입 | 필수 | 범위 |
| ------- | ------------------------- | ------ | -- | -- |
| `audio` | 아바타가 립싱크할 오디오입니다(최대 10분). | AUDIO  | 예  |    |

## 출력

| 출력 이름   | 설명                   | 데이터 타입 |
| ------- | -------------------- | ------ |
| `VIDEO` | 생성된 아바타 프레젠터 동영상입니다. | VIDEO  |

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

***

**Source fingerprint (SHA-256):** `009bc72b841ca273af83fe6f80fb24d4b11c2efd96c011795b1ff1cf8e66ee61`