> ## 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. # HeyGenReferenceToVideoNode - ComfyUI Built-in Node Documentation > HeyGen Video 1.0을 사용하여 텍스트 프롬프트로부터 동기화된 대사와 사운드가 포함된 비디오를 생성하며, 선택적으로 연결된 참조 자료의 안내를 받을 수 있습니다. 사람, 제품 또는 장소의 이미지, 재사용할 비디오, 목소리를 제공하는 오디오 클립을 모두 참조로 사용할 수 있습니다. 프롬프트에서 각 참조를 @Imag HeyGen Video 1.0을 사용하여 텍스트 프롬프트로부터 동기화된 대사와 사운드가 포함된 비디오를 생성하며, 선택적으로 연결된 참조 자료의 안내를 받을 수 있습니다. 사람, 제품 또는 장소의 이미지, 재사용할 비디오, 목소리를 제공하는 오디오 클립을 모두 참조로 사용할 수 있습니다. 프롬프트에서 각 참조를 @Image1, @Video1 또는 @Audio1로 언급하세요. 번호는 입력이 연결된 순서에 따라 유형별로 매겨집니다. 이러한 태그는 HeyGen이 기대하는 레이블로 재작성되며, 연결되지 않은 참조를 가리키는 태그는 오류를 발생시킵니다. 참조 이미지나 비디오가 없으면 노드는 텍스트-투-비디오 생성으로 실행됩니다. ## 입력 | 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 | | - | - | - | - | - | | `모델` | 생성에 사용되는 모델 버전입니다. (기본값: `"heygen-video-1"`) | DYNAMIC\_COMBO | 예 | `"heygen-video-1"` | | `prompt` | 비디오에 대한 설명이며, 모든 대사를 포함합니다. 연결된 참조를 @Image1, @Video1, @Audio1로 참조하세요. 번호는 입력 순서에 따라 유형별로 매겨집니다. (기본값: 빈 문자열) | STRING | 예 | 1 \~ 32000자 | | `duration` | 출력 비디오의 길이(초)입니다. (기본값: 5) | INT | 예 | 5 \~ 15 | | `resolution` | 출력 해상도입니다. (기본값: `"768p"`) | COMBO | 예 | `"768p"`
`"480p"` | | `aspect_ratio` | 출력 화면 비율입니다. 참조가 연결되지 않은 경우 `"auto"`는 16:9이며, 그렇지 않으면 첫 번째 참조 이미지를 따르고, 이미지가 연결되지 않은 경우에는 첫 번째 참조 비디오를 따릅니다. (기본값: `"auto"`) | COMBO | 예 | `"auto"`
`"16:9"`
`"9:16"`
`"1:1"`
`"4:3"`
`"3:4"`
`"21:9"` | | `seed` | 생성용 시드입니다. 동일한 시드를 사용하더라도 실행할 때마다 결과가 달라질 수 있습니다. (기본값: 42) | INT | 예 | 0 \~ 4294967295 | | `reference_images` | 확장 가능한 슬롯: 비디오에 사용할 사람, 제품 또는 장소의 이미지입니다(`image_1` ... `image_9`). @Image1, @Image2, ...로 참조하세요. 각 입력에는 정확히 하나의 이미지가 포함되어야 하며, 각 이미지의 화면 비율은 1:4에서 4:1 사이여야 합니다. | IMAGE | 아니요 | 0 \~ 9개 이미지 | | `reference_videos` | 확장 가능한 슬롯: 참조로 사용할 비디오입니다(`video_1` ... `video_3`). @Video1, @Video2, ...로 참조하세요. | VIDEO | 아니요 | 0 \~ 3개 비디오 | | `reference_audios` | 확장 가능한 슬롯: 화자를 위한 목소리와 같은 오디오 클립입니다(`audio_1` ... `audio_3`). @Audio1, @Audio2, ...로 참조하세요. 최소 하나의 참조 이미지 또는 비디오가 필요합니다. 음성 참조에는 몇 초 분량의 깨끗한 음성이 필요하며, 약 2초보다 짧은 클립은 일반적으로 무시됩니다. | AUDIO | 아니요 | 0 \~ 3개 클립 | ### 매개변수 제약 조건 * **참조 제한:** `reference_images`, `reference_videos`, `reference_audios`를 통틀어 최대 12개의 참조만 가능합니다. 더 많이 연결하면 오류가 발생합니다. * **오디오에는 이미지 또는 비디오 필요:** 참조 이미지와 참조 비디오가 모두 연결되지 않은 경우 참조 오디오는 거부됩니다. * **참조 이미지 규칙:** 각 `reference_images` 입력에는 정확히 하나의 이미지만 포함해야 하며(배치는 거부됨), 각 이미지의 화면 비율은 1:4에서 4:1 사이여야 합니다. * **프롬프트 태그:** `@ImageN`, `@VideoN`, `@AudioN`은 대소문자를 구분하지 않고 일치합니다. 숫자는 해당 유형에 연결된 참조 수를 초과해서는 안 되며, 프롬프트는 공백을 제거한 후 비어 있지 않아야 합니다. * **모드:** 참조 이미지 또는 비디오가 하나 이상 있으면 요청은 참조-투-비디오 실행입니다. 없으면 일반 텍스트-투-비디오 실행입니다. * **시드:** 시드는 노드의 재실행 여부만 결정하며, 동일한 시드로도 결과를 재현할 수 없습니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | | - | - | - | | `VIDEO` | 동기화된 대사와 사운드가 포함된 생성된 비디오입니다. | VIDEO | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HeyGenReferenceToVideoNode/ko.md) *** **Source fingerprint (SHA-256):** `44de381703821043aa1399e58c9132f9b6a2b0ac5dbf47197dffed0438ea7ad7` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.