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

# HeyGenTalkingPhotoNode - ComfyUI Built-in Node Documentation

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

정지된 인물 사진을 HeyGen의 Avatar IV 기술을 사용하여 립싱크가 적용된 말하는 동영상으로 애니메이션화합니다. HeyGen이 음성으로 변환하는 텍스트 스크립트로 애니메이션을 구동하거나, 아바타가 립싱크할 자체 오디오를 제공할 수 있습니다.

## 입력

| 매개변수              | 설명                                                                                       | 데이터 타입 | 필수 여부                   | 범위                                                                          |
| ----------------- | ---------------------------------------------------------------------------------------- | ------ | ----------------------- | --------------------------------------------------------------------------- |
| `image`           | 애니메이션화할 인물의 이미지입니다. 2K보다 큰 경우 자동으로 축소됩니다.                                                | IMAGE  | 예                       | -                                                                           |
| `speech`          | 텍스트 스크립트(HeyGen 텍스트 음성 변환) 또는 자체 오디오로 아바타를 구동합니다.                                        | COMBO  | 예                       | `"script"`<br />`"audio"`                                                   |
| `text`            | 아바타가 말할 텍스트입니다(최대 5000자). 생성된 음성은 최소 1초 이상이어야 합니다.                                       | STRING | 예(speech가 "script"인 경우) | -                                                                           |
| `voice`           | 스크립트에 사용할 음성입니다(HeyGen의 가장 인기 있는 음성).                                                    | COMBO  | 예(speech가 "script"인 경우) | 여러 옵션 사용 가능                                                                 |
| `custom_voice_id` | 선택적 HeyGen 음성 ID입니다. 설정 시 위에서 선택한 음성을 재정의합니다. HeyGen 라이브러리(2000개 이상)의 모든 음성을 사용할 수 있습니다. | STRING | 아니요                     | -                                                                           |
| `voice_speed`     | 음성 속도 배율입니다(기본값: 1.0).                                                                   | FLOAT  | 아니요                     | 0.5 \~ 1.5                                                                  |
| `audio`           | 아바타가 립싱크할 오디오로, 최대 10분까지 가능합니다.                                                          | AUDIO  | 예(speech가 "audio"인 경우)  | -                                                                           |
| `resolution`      | 출력 동영상 해상도입니다(기본값: "1080p").                                                             | COMBO  | 아니요                     | `"720p"`<br />`"1080p"`                                                     |
| `aspect_ratio`    | 출력 화면 비율입니다. 'auto'는 입력 이미지를 따릅니다(기본값: "auto").                                          | COMBO  | 아니요                     | `"auto"`<br />`"16:9"`<br />`"9:16"`<br />`"1:1"`<br />`"4:5"`<br />`"5:4"` |
| `expressiveness`  | 애니메이션 얼굴과 제스처의 표현력 정도입니다(기본값: "low").                                                    | COMBO  | 아니요                     | `"low"`<br />`"medium"`<br />`"high"`                                       |
| `seed`            | HeyGen으로 전송되지 않습니다. 값을 변경하여 재실행을 강제합니다(기본값: 42).                                         | INT    | 아니요                     | 0 \~ 2147483647                                                             |

## 출력

| 출력 이름   | 설명                                     | 데이터 타입 |
| ------- | -------------------------------------- | ------ |
| `video` | 립싱크된 음성이 포함된 애니메이션 말하는 사진의 생성된 동영상입니다. | VIDEO  |

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

***

**Source fingerprint (SHA-256):** `2181066a8c6191cfcaa15ece4f89a16c37e76aa22763d6df4007baa20336f05a`