> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# HeyGenTalkingPhotoNode - ComfyUI Built-in Node Documentation

> HeyGen의 Avatar IV 기술을 사용하여 사람의 정지 이미지를 립싱크가 적용된 말하는 동영상으로 애니메이션합니다.

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

## 입력

### 공통 입력

| 매개변수             | 설명                                                  | 데이터 타입         | 필수 여부 | 범위                                                                          |
| ---------------- | --------------------------------------------------- | -------------- | ----- | --------------------------------------------------------------------------- |
| `image`          | 애니메이션할 사람의 이미지입니다. 2K보다 크면 자동으로 다운스케일됩니다.           | IMAGE          | 예     | -                                                                           |
| `speech`         | 텍스트 스크립트(HeyGen 텍스트 음성 변환) 또는 자체 오디오로 아바타를 구동합니다.   | DYNAMIC\_COMBO | 예     | `"script"`<br />`"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                                                             |

### 스크립트 입력

`speech`가 `"script"`일 때 표시됩니다.

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

### 오디오 입력

`speech`가 `"audio"`일 때 표시됩니다.

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

참고: `speech`가 `"script"`인 경우 `text`를 지정해야 하며, `voice` 선택기(아바타의 기본 음성이 아닌 다른 음성 선택) 또는 `custom_voice_id`를 통해 음성을 지정해야 합니다. `speech`가 `"audio"`인 경우 `audio`가 대신 필요합니다.

## 출력

| 출력 이름   | 설명                                       | 데이터 타입 |
| ------- | ---------------------------------------- | ------ |
| `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`