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

# HeyGen Avatar 6: ComfyUI 사진과 아이덴티티에서 비디오로

> 사진, 스타일화된 캐릭터 또는 HeyGen 아바타를 ComfyUI에서 Avatar 6로 말하게 해 보세요: 직접 준비한 오디오, 작성한 스크립트, 1080p 및 2K 출력.

**HeyGen Avatar 6**는 사진, 짧은 캐릭터 비디오 또는 HeyGen 아바타 룩을 직접 제공하거나 작성한 음성에 립싱크된 말하는 클립으로 변환합니다.

ComfyUI에서는 두 개의 파트너 노드를 통해 실행됩니다. **HeyGen Avatar 6 Reference to Video**는 사진이나 스타일화된 캐릭터를 자체 오디오 트랙으로 애니메이션화합니다. **HeyGen Avatar 6 Identity to Video**는 작성한 스크립트를 바탕으로 선택한 음성으로 기본 제공 또는 커스텀 아바타를 렌더링합니다. 둘 다 클라우드 API 노드이므로 크레딧이 있는 Comfy 계정이 필요하고 로컬 모델을 다운로드하지 않습니다. 요금은 [파트너 노드 가격 페이지](https://docs.comfy.org/ko/tutorials/partner-nodes/pricing.md)에서 확인할 수 있습니다.

모든 실행은 1080p 또는 2K로 렌더링되며 화면 비율은 16:9, 9:16, 1:1, 4:5, 5:4 중에서 선택할 수 있고, 클립 길이는 음성 길이를 따릅니다. `heygen-avatar-6`이 기본 엔진이며, `heygen-avatar-6-turbo`는 더 빠르고 저렴한 옵션입니다.

> [!TIP]
>
> 파트너 노드를 사용하려면 올바르게 로그인되어 있고 허가된 네트워크 환경을 사용하고 있는지 확인해야 합니다. 파트너 노드를 사용하기 위한 구체적인 요구사항은 문서의 [파트너 노드 개요](https://docs.comfy.org/ko/tutorials/partner-nodes/overview.md) 섹션을 참조해 주세요.

> [!TIP]
>
> > [tab] 로컬 사용자
> >
> > ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.
> >
> > * [ComfyUI 다운로드](https://www.comfy.org/download)
> > * [업데이트 가이드](https://docs.comfy.org/ko/installation/update_comfyui.md)
> >
> > 이 가이드의 워크플로는 [워크플로 템플릿](https://docs.comfy.org/ko/interface/features/template.md)에서 확인할 수 있습니다.
> > 템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다.
> >
> > 워크플로를 로드할 때 노드가 누락되는 경우, 가능한 원인:
> >
> > 1. 최신 ComfyUI 버전(최신 테스트 버전(nightly))을 사용하고 있지 않음
> > 2. 일부 노드가 시작 시 가져오기에 실패함
>
> > [tab] 클라우드 사용자
> >
> > * [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.
> >
> > 따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.

## 사용 가능한 워크플로

### 사진 또는 비디오에서 비디오로

사진 한 장, 스타일화된 캐릭터의 짧은 비디오 하나, 또는 둘 다를 사용자의 오디오로 말하는 클립으로 변환합니다. 오디오가 렌더의 길이를 결정합니다.

* 사진은 인물의 정체성과 장면을 설정합니다. 첫 프레임으로 사용되지는 않습니다. 모델이 포즈를 다시 연출하므로, 팔짱을 낀 사진은 포즈가 바뀐 채로 돌아옵니다.
* 참조 비디오는 캐릭터가 말하고 움직이는 방식을 보여 주며, 최소 2초 이상이어야 합니다. 더 긴 클립은 처음 30초로 잘립니다. 실사 인물 비디오는 거부되므로, 대신 그 인물의 사진을 연결하세요.
* 오디오는 1.5초에서 10분까지입니다.

<video controls src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_heygen_avatar_6_i2v.mp4" />

> [card] [Comfy Cloud에서 실행](https://cloud.comfy.org/?template=api_heygen_avatar_6_i2v\&utm_source=docs\&utm_medium=referral\&utm_campaign=heygen-avatar-6)
>
> Comfy Cloud에서 열기

> [card] [워크플로 다운로드](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_heygen_avatar_6_i2v.json)
>
> JSON을 다운로드하거나 템플릿 라이브러리에서 "HeyGen Avatar 6: Photo to Video"를 검색하세요

**입력 자료**

> [card] [pink\_hair\_portrait.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_hair_portrait.png)
>
> `image` 입력에 로드

> [card] [avatar6\_narration.mp3](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/avatar6_narration.mp3)
>
> `audio` 입력에 로드

### 아이덴티티에서 비디오로

촬영 없이 프레젠터를 렌더링합니다. 기본 제공 룩이나 직접 만든 아바타를 선택하고, 대사를 작성하고, 음성을 고르세요. `speech`가 `script`이면 아무것도 연결할 필요가 없고, `audio`이면 Load Audio 노드를 `audio` 입력에 연결하세요.

`speech`에는 두 가지 모드가 있습니다. **script**는 대사를 `text`에 작성하고(최대 5000자) 선택한 `voice`로 말하며, 선택적으로 `voice_speed` 배수를 사용할 수 있습니다. **audio**는 0.5초에서 10분 길이의 사용자 클립을 받으며, 클립 길이가 렌더 길이가 됩니다.

<video controls src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/api_heygen_avatar_6_id2v.mp4" />

> [card] [Comfy Cloud에서 실행](https://cloud.comfy.org/?template=api_heygen_avatar_6_id2v\&utm_source=docs\&utm_medium=referral\&utm_campaign=heygen-avatar-6)
>
> Comfy Cloud에서 열기

> [card] [워크플로 다운로드](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_heygen_avatar_6_id2v.json)
>
> JSON을 다운로드하거나 템플릿 라이브러리에서 "HeyGen Avatar 6: Identity to Video"를 검색하세요

템플릿에는 직접 아바타와 음성을 만드는, 바이패스된 그룹 두 개도 포함되어 있습니다. 그룹의 노드를 선택해 **Ctrl+B**로 바이패스를 해제한 다음 **실행** 또는 **Ctrl+Enter**로 워크플로를 실행하고, 저장된 ID를 재사용하세요. 저장되는 텍스트는 접두사와 ID를 이어 붙인 것이므로 먼저 **Concatenate Text**의 `string_a` 접두사를 지우거나 생성 노드 출력에서 원본 ID를 복사하세요.

* **아바타**: `source`를 `photo`로 설정한 `HeyGen Create Avatar`가 룩 ID를 반환합니다. 메인 노드에서 `avatar`를 `custom avatar`로 설정하고 ID를 `custom_avatar_id`에 붙여넣으세요. `pink_hair_portrait.png`가 템플릿에 포함되어 있습니다.
* **음성**: `HeyGen Voice 1.0 Instant Clone`은 최소 10초의 깨끗한 단일 화자 오디오로부터 음성 ID를 반환합니다. 이를 `custom_voice_id`에 붙여넣으세요. 값이 비어 있지 않으면 `voice` 드롭다운을 덮어씁니다. `avatar6_voice_sample.mp3`가 템플릿에 포함되어 있습니다.

## 노드 컨트롤

| 컨트롤 | 값 | 적용 대상 | 효과 |
| - | - | - | - |
| `model` | `heygen-avatar-6`, `heygen-avatar-6-turbo` | 두 노드 모두 | 엔진. Turbo는 더 저렴하고 빠름 |
| `resolution` | `1080p`, `2k` | 두 노드 모두 | 16:9는 `1080p`에서 1920x1080, `2k`에서 2880x1620으로 렌더링 |
| `aspect_ratio` | `auto`, `16:9`, `9:16`, `1:1`, `4:5`, `5:4` | 두 노드 모두 | `auto`는 사진을 따르며, 사진이 연결되지 않은 경우 비디오를 따르고, Identity to Video에서는 아바타의 소스 영상를 따름. 다른 값은 장면을 다시 프레이밍 |
| `motion_prompt` | 텍스트, 최대 1200자 | 두 노드 모두 | 제스처, 표정, 자세, 카메라 움직임 |
| `motion_expressiveness` | `less`, `default` | 두 노드 모두 | `less`는 제스처를 억제함. 겹치는 부분에서는 모션 프롬프트가 우선 |
| `seed` | 정수 | 두 노드 모두 | 노드 재실행 여부를 제어하며, 결과는 어쨌든 실행마다 달라짐 |
| `image` | 사진 한 장 | Reference to Video | 클립의 정체성과 장면. 첫 프레임으로는 사용되지 않음 |
| `video` | 클립 하나, 2\~30초 | Reference to Video | 캐릭터가 말하고 움직이는 방식. 실사 인물은 거부됨 |
| `audio` | 1.5초 \~ 10분 | Reference to Video | 립싱크할 음성 및 클립의 길이 |
| `avatar` | 스톡 룩, `custom avatar` | Identity to Video | 발표자. `custom avatar`를 선택하면 `custom_avatar_id`가 나타남 |
| `speech` | `script`, `audio` | Identity to Video | 선택한 음성으로 작성한 대사, 또는 직접 준비한 오디오 클립 |

Reference to Video에는 이미지, 비디오 중 하나 이상이 연결되어야 합니다. Identity to Video는 `script` 모드에서는 입력 연결이 필요 없고, `audio` 모드에서는 오디오 입력이 필요합니다.

## 프롬프트 작성 팁

* **`motion_prompt`에서 연기를 지시하세요**. 아바타가 말하고 움직이는 방식을 설명하세요: 핵심 단어에서의 제스처, 편안한 어깨, 약간의 머리 기울임, 카메라의 느린 푸시인. 중립적인 전달을 원하면 비워 두세요.
* **프레임이 좁을 때는 제스처를 작게 유지하세요**. 머리와 어깨 크롭에는 `motion_expressiveness`를 `less`로 설정하세요. 넓은 제스처는 프레임 밖으로 나가기 때문입니다.
* **깔끔한 단일 화자 오디오를 사용하세요**. 트랙의 배경 음악이나 두 번째 목소리는 립싱크에 나타납니다. 음성 복제의 경우 10초의 연속 음성이면 충분합니다.
* **사진을 연결하기 전에 구도를 잡으세요**. `auto`는 사진의 형태를 유지하므로, 나중에 다시 구도를 잡는 대신 원하는 가로세로 비율로 크롭하세요.

## 시작하기

1. ComfyUI를 최신 버전으로 업데이트하세요
2. Template Library로 이동하여 `HeyGen Avatar 6`을 검색하세요


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.