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

# HeyGenCreateAvatarNode - ComfyUI Built-in Node Documentation

> 사람의 사진 또는 생성할 캐릭터를 설명하는 텍스트 프롬프트에서 재사용 가능한 HeyGen 아바타를 생성합니다. 생성된 avatarid는 HeyGen Avatar Video 노드에서 사용할 수 있으며, 향후 워크플로에서 아바타를 재사용하려면 저장해야 합니다.

사람의 사진 또는 생성할 캐릭터를 설명하는 텍스트 프롬프트에서 재사용 가능한 HeyGen 아바타를 생성합니다. 생성된 `avatar_id`는 HeyGen Avatar Video 노드에서 사용할 수 있으며, 향후 워크플로에서 아바타를 재사용하려면 저장해야 합니다.

## 입력

### 공통 입력

| 매개변수 | 설명                                                | 데이터 타입         | 필수 | 범위                        |
| ---- | ------------------------------------------------- | -------------- | -- | ------------------------- |
| `소스` | 텍스트 프롬프트에서 새 캐릭터를 생성하거나, 연결된 사람의 사진에서 아바타를 생성합니다. | DYNAMIC\_COMBO | 예  | `"prompt"`<br />`"photo"` |

### 프롬프트 입력

`source`가 `"prompt"`로 설정된 경우 사용할 수 있습니다.

| 매개변수     | 설명                                                                     | 데이터 타입 | 필수 | 범위       |
| -------- | ---------------------------------------------------------------------- | ------ | -- | -------- |
| `prompt` | 생성할 아바타에 대한 설명(최대 1000자). 공백 문자 외의 문자가 최소 1자 이상 포함되어야 합니다. 기본값: 빈 문자열. | STRING | 예  | 1\~1000자 |

### 사진 입력

`source`가 `"photo"`로 설정된 경우 사용할 수 있습니다.

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

### 참조 입력

`source`가 `"prompt"`로 설정된 경우 사용할 수 있습니다.

| 매개변수               | 설명                                                                                                        | 데이터 타입 | 필수  | 범위        |
| ------------------ | --------------------------------------------------------------------------------------------------------- | ------ | --- | --------- |
| `reference_images` | 확장 가능한 슬롯: 생성될 외형을 안내하는 최대 3개의 이미지(`ref_image_1`...`ref_image_3`)를 연결할 수 있습니다. 이미지가 2K보다 큰 경우 자동으로 축소됩니다. | IMAGE  | 아니요 | 0\~3개 이미지 |

**참고:** `source` 매개변수는 상호 배타적인 두 모드 사이를 전환합니다. `"prompt"` 모드에서는 `prompt`가 필수이며 최대 3개의 참조 이미지를 선택적으로 연결할 수 있습니다. `"photo"` 모드에서는 `identity_photo`가 필수입니다. 사진과 참조 이미지는 2K보다 큰 경우 자동으로 축소되며, 3개를 초과하는 참조 이미지는 허용되지 않습니다.

## 출력

| 출력 이름       | 설명                                                                                        | 데이터 타입 |
| ----------- | ----------------------------------------------------------------------------------------- | ------ |
| `avatar_id` | 아바타 룩 ID입니다. HeyGen Avatar Video의 `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):** `3669686fc6d089909bd5d2d75292ceef05702ed3cc7b14e561bcb444c30a4e63`
