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

# HeyGenCreateAvatarNode - ComfyUI Built-in Node Documentation

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

사람의 사진이나 캐릭터를 설명하는 텍스트 프롬프트로부터 재사용 가능한 HeyGen 아바타를 생성합니다. 생성된 아바타 ID는 HeyGen 아바타 비디오 노드와 함께 사용하여 이 아바타가 등장하는 비디오를 제작할 수 있습니다.

## 입력

| 매개변수 | 설명                                             | 데이터 타입 | 필수 여부 | 범위                        |
| ---- | ---------------------------------------------- | ------ | ----- | ------------------------- |
| `소스` | 텍스트 프롬프트로 새 캐릭터를 생성하거나, 연결된 사람 사진으로 아바타를 만듭니다. | COMBO  | 예     | `"prompt"`<br />`"photo"` |

`source`가 `"prompt"`로 설정된 경우, 다음 추가 매개변수를 사용할 수 있습니다:

| 매개변수               | 설명                             | 데이터 타입 | 필수 여부 | 범위        |
| ------------------ | ------------------------------ | ------ | ----- | --------- |
| `prompt`           | 생성할 아바타에 대한 설명입니다 (최대 1000자).  | STRING | 예     | 1\~1000자  |
| `reference_images` | 생성될 외형을 안내하는 최대 3개의 참조 이미지입니다. | IMAGE  | 아니요   | 0\~3개 이미지 |

`source`가 `"photo"`로 설정된 경우, 다음 추가 매개변수를 사용할 수 있습니다:

| 매개변수             | 설명                                        | 데이터 타입 | 필수 여부 | 범위     |
| ---------------- | ----------------------------------------- | ------ | ----- | ------ |
| `identity_photo` | 아바타로 변환할 사람의 사진입니다. 2K보다 클 경우 자동으로 축소됩니다. | IMAGE  | 예     | 단일 이미지 |

**참고:** `source` 매개변수는 두 가지 모드 사이를 전환합니다. `"prompt"` 모드에서는 텍스트 설명과 선택적으로 최대 3개의 참조 이미지를 제공합니다. `"photo"` 모드에서는 사람의 단일 사진을 제공합니다. 이 두 모드는 상호 배타적입니다.

## 출력

| 출력 이름       | 설명                                                                            | 데이터 타입 |
| ----------- | ----------------------------------------------------------------------------- | ------ |
| `avatar_id` | 아바타 외형 ID입니다. HeyGen 아바타 비디오의 `custom_avatar_id`에 전달하거나 저장하여 나중에 아바타를 재사용하세요. | STRING |
| `미리보기`      | 생성된 아바타의 미리보기 이미지입니다.                                                         | IMAGE  |

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

***

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