> ## Documentation Index > Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # ByteDance2ReferenceNodeV2 - ComfyUI Built-in Node Documentation > ByteDance Seedance 2.5 Reference to Video는 텍스트 프롬프트와 선택적 참조 이미지, 비디오, 오디오 또는 이전에 업로드한 라이브러리 자산의 안내를 받아 ByteDance Seedance 모델(Seedance 2.5, 2.5 Draft, 2.0, 2.0 Fast, 2.0 Mini)을 사용하여 ByteDance Seedance 2.5 Reference to Video는 텍스트 프롬프트와 선택적 참조 이미지, 비디오, 오디오 또는 이전에 업로드한 라이브러리 자산의 안내를 받아 ByteDance Seedance 모델(Seedance 2.5, 2.5 Draft, 2.0, 2.0 Fast, 2.0 Mini)을 사용하여 비디오를 생성, 편집 또는 확장합니다. 참조를 업로드하고, 생성 작업을 제출하고, 완료를 기다린 뒤, 완성된 비디오 파일을 반환합니다. `Seedance 2.5 Draft`를 선택하면 대신 빠른 480p 미리보기를 렌더링합니다. 결과로 나온 `draft_task_id`를 ByteDance Seedance 2.5 Draft to Final Video 노드에 연결하여 1080p 최종본을 렌더링하세요. ## 입력 ### 공통 입력 | 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | | - | - | - | - | - | | `모델` | 모델 선택기입니다. Seedance 2.5는 최신 모델로 최대 30초 비디오와 mp4 출력을 지원합니다. Seedance 2.5 Draft는 빠른 480p 미리보기용이며, 해당 `draft_task_id` 출력을 ByteDance Seedance 2.5 Draft to Final Video 노드에서 렌더링하면 1080p 최종본이 됩니다. Seedance 2.0은 최대 품질과 4k용입니다. Fast는 속도 최적화용입니다. Mini는 가장 빠르고 비용이 가장 낮은 생성용입니다. 모델을 선택하면 아래에 표시되는 입력 위젯이 변경됩니다. | DYNAMIC\_COMBO | 예 | "Seedance 2.5"
"Seedance 2.5 Draft"
"Seedance 2.0"
"Seedance 2.0 Fast"
"Seedance 2.0 Mini" | | `시드` | 시드는 노드를 다시 실행할지 여부를 제어합니다. 시드와 관계없이 결과는 비결정적입니다. 기본값: 0. | INT | 예 | 0\~2147483647 | | `워터마크` | 비디오에 워터마크를 추가할지 여부입니다. 기본값: False. 고급 설정입니다. | BOOLEAN | 예 | true
false | ### Seedance 2.5 입력 이 입력은 `model`이 "Seedance 2.5"로 설정된 경우 나타납니다. | 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | | - | - | - | - | - | | `prompt` | 비디오 생성을 위한 텍스트 프롬프트입니다. 생성된 대사를 유도하려면 말할 대사를 큰따옴표로 묶으세요. 기본값: 빈 문자열. | STRING | 예 | 여러 줄 텍스트 | | `resolution` | 출력 비디오의 해상도입니다. 기본값: 720p. | COMBO | 예 | "480p"
"720p"
"1080p" | | `ratio` | 출력 비디오의 화면 비율입니다. 기본값: 16:9. | COMBO | 예 | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | | `duration` | 출력 비디오의 길이(초)입니다(4-30). 기본값: 5. | INT | 예 | 4\~30 | | `generate_audio` | 출력 비디오의 오디오 생성을 활성화합니다. 기본값: True. | BOOLEAN | 예 | true
false | | `task_type` | 참조 미디어로 수행할 작업입니다. auto를 제외한 모든 값은 작업 제출 시 검증되므로, 설정이 맞지 않으면 생성이 시작되기 전에 실패합니다.
auto: 모델이 프롬프트와 입력으로부터 작업을 추론하며, 모델의 해석과 충돌하는 설정은 생성이 시작된 후에만 실패합니다.
reference: 참조 이미지, 비디오 및 오디오의 안내를 받아 새 비디오를 생성합니다.
edit: 연결된 참조 비디오를 변경합니다(추가, 제거, 교체). 출력은 원본 클립 자체의 길이와 화면 비율을 유지하며 `duration` 및 `ratio` 위젯은 무시됩니다.
extend: 연결된 참조 비디오를 앞뒤로 이어갑니다. 프롬프트에는 "extend forward", "extend backward" 또는 "continue"라고 명시해야 하며, 화면 비율은 원본 클립을 따르고, 출력에는 설정한 길이의 새로 생성된 부분만 포함되고 원본 클립은 포함되지 않습니다. 기본값: auto. | COMBO | 예 | "auto"
"reference"
"edit"
"extend" | | `output_format` | 출력 비디오의 컨테이너 형식입니다. 기본값: mp4. | COMBO | 예 | "mp4" | ### Seedance 2.5 Draft 입력 이 입력은 `model`이 "Seedance 2.5 Draft"로 설정된 경우 나타납니다. 매개변수 집합은 위의 Seedance 2.5와 동일하지만, `resolution`은 `"480p"`만 제공합니다(기본값 `"480p"`). ### Seedance 2.0 입력 이 입력은 `model`이 "Seedance 2.0"으로 설정된 경우 나타납니다. | 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | | - | - | - | - | - | | `prompt` | 비디오 생성을 위한 텍스트 프롬프트입니다. 기본값: 빈 문자열. | STRING | 예 | 여러 줄 텍스트 | | `resolution` | 출력 비디오의 해상도입니다. | COMBO | 예 | "480p"
"720p"
"1080p"
"4k" | | `ratio` | 출력 비디오의 화면 비율입니다. 기본값: adaptive. | COMBO | 예 | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | | `duration` | 출력 비디오의 길이(초)입니다(4-15). 기본값: 7. | INT | 예 | 4\~15 | | `generate_audio` | 출력 비디오의 오디오 생성을 활성화합니다. 기본값: True. | BOOLEAN | 예 | true
false | ### Seedance 2.0 Fast 및 Seedance 2.0 Mini 입력 이 입력은 `model`이 "Seedance 2.0 Fast" 또는 "Seedance 2.0 Mini"로 설정된 경우 나타납니다. 두 모델은 동일한 입력 집합을 공유합니다. | 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | | - | - | - | - | - | | `prompt` | 비디오 생성을 위한 텍스트 프롬프트입니다. 기본값: 빈 문자열. | STRING | 예 | 여러 줄 텍스트 | | `resolution` | 출력 비디오의 해상도입니다. | COMBO | 예 | "480p"
"720p" | | `ratio` | 출력 비디오의 화면 비율입니다. 기본값: adaptive. | COMBO | 예 | "16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive" | | `duration` | 출력 비디오의 길이(초)입니다(4-15). 기본값: 7. | INT | 예 | 4\~15 | | `generate_audio` | 출력 비디오의 오디오 생성을 활성화합니다. 기본값: True. | BOOLEAN | 예 | true
false | ### 참조 입력 이러한 확장 가능한 참조 슬롯은 모든 모델에서 사용할 수 있습니다. 최대 슬롯 수는 모델마다 다릅니다. Seedance 2.5는 최대 30개 이미지, 10개 비디오, 10개 오디오, 30개 자산을 지원하고, Seedance 2.0, 2.0 Fast, 2.0 Mini는 최대 9개 이미지, 3개 비디오, 3개 오디오, 9개 자산을 지원합니다. | 매개변수 | 설명 | 데이터 유형 | 필수 | 범위 | | - | - | - | - | - | | `reference_images` | 확장 가능한 슬롯: 출력을 안내하는 1..N개의 참조 이미지를 연결합니다. 개수 제한은 모델마다 다릅니다(모델 섹션 참조). 이미지는 화면 비율(0.4\~2.5)이 검증되며 최대 변 6000픽셀로 자동 축소됩니다. | IMAGE | 아니요 | 1..9 슬롯(Seedance 2.0 계열)
1..30 슬롯(Seedance 2.5) | | `reference_videos` | 확장 가능한 슬롯: 1..N개의 참조 비디오를 연결합니다. 개수 제한은 모델마다 다릅니다(모델 섹션 참조). 각 비디오는 최소 1.8초 길이여야 하며 선택한 모델과 해상도의 픽셀 제한에 맞아야 합니다. | VIDEO | 아니요 | 1..3 슬롯(Seedance 2.0 계열)
1..10 슬롯(Seedance 2.5) | | `reference_audios` | 확장 가능한 슬롯: 1..N개의 참조 오디오 트랙을 연결합니다. 개수 제한은 모델마다 다릅니다(모델 섹션 참조). 각 오디오는 최소 1.8초 길이여야 합니다. | AUDIO | 아니요 | 1..3 슬롯(Seedance 2.0 계열)
1..10 슬롯(Seedance 2.5) | | `reference_assets` | 확장 가능한 슬롯: Seedance 가상 라이브러리에 이미 업로드된 미디어의 자산 ID 문자열을 1..N개 연결합니다. 각 자산은 Active 상태여야 합니다. 프롬프트에서 `asset1` 또는 `asset 1`과 같은 토큰으로 자산을 참조할 수 있습니다. 노드는 이를 자산의 위치 레이블(예: "Image 2" 또는 "Video 1")로 대체합니다. | STRING | 아니요 | 1..9 슬롯(Seedance 2.0 계열)
1..30 슬롯(Seedance 2.5) | | `auto_downscale` | 선택한 해상도에 대한 모델의 픽셀 예산을 초과하는 참조 비디오를 자동으로 축소합니다. 화면 비율은 유지되며, 이미 제한 내에 있는 비디오는 변경되지 않습니다. 기본값: True. | BOOLEAN | 아니요 | true
false | | `auto_upscale` | 선택한 해상도에 대한 모델의 최소 픽셀 수보다 작은 참조 비디오를 자동으로 업스케일합니다. 화면 비율은 유지되며, 이미 최소값을 충족하는 비디오는 변경되지 않습니다. 참고: 저해상도 소스를 업스케일해도 실제 디테일이 추가되지 않으며 더 낮은 품질의 생성 결과가 나올 수 있습니다. 기본값: False. 고급 설정입니다. | BOOLEAN | 아니요 | true
false | **참고:** 노드를 실행하려면 최소 하나의 참조 이미지, 비디오 또는 자산이 필요합니다(Seedance 2.5는 오디오만 있는 참조도 허용합니다). 참조 비디오와 오디오는 각각 최소 1.8초 길이여야 하며, 모든 참조 비디오의 총 길이(그리고 별도로 모든 참조 오디오의 총 길이)는 선택한 모델의 최대 총 길이(초)를 초과해서는 안 됩니다. 참조 이미지는 화면 비율이 대략 2:5에서 5:2(0.4\~2.5) 사이여야 하고, 최소 300x300픽셀이어야 하며, 최대 변 6000픽셀로 자동 축소됩니다. `task_type`의 "edit" 및 "extend" 옵션은 Seedance 2.5에서만 사용할 수 있으며 둘 다 최소 하나의 참조 비디오가 필요합니다. "edit"을 사용하면 출력은 원본 클립 자체의 길이와 화면 비율을 유지하고 `duration` 및 `ratio` 위젯은 무시되며, "extend"를 사용하면 출력에는 설정한 길이의 새로 생성된 부분만 포함됩니다. 참조된 자산은 Active 상태여야 하며, 그렇지 않으면 작업이 실패합니다. 모든 실행은 작업 ID를 `draft_task_id`로 반환하지만, `Seedance 2.5 Draft` 실행의 ID만 ByteDance Seedance 2.5 Draft to Final Video 노드에서 렌더링할 수 있으므로 다른 모델을 사용하는 경우 출력을 연결하지 않은 상태로 두어야 하며, 그렇지 않으면 실행이 실패합니다. ## 출력 | 출력 이름 | 설명 | 데이터 유형 | | - | - | - | | `video` | 생성된 비디오로, 생성 작업이 완료되면 제공자로부터 다운로드됩니다. 오디오 생성이 활성화된 경우 오디오를 포함합니다. | VIDEO | | `draft_task_id` | 실행에서 반환된 작업 ID입니다. `Seedance 2.5 Draft` 실행만 ByteDance Seedance 2.5 Draft to Final Video 노드에서 렌더링할 수 있는 드래프트를 생성합니다. 다른 모델을 사용하는 경우 출력을 연결하지 않은 상태로 두어야 하며, 그렇지 않으면 실행이 실패합니다. | STRING | > 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ByteDance2ReferenceNodeV2/ko.md) *** **Source fingerprint (SHA-256):** `12fee29b280ff71e29f268f52131d1c15cf3066e0804356b735b61d97c80a6a9` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.