> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ByteDance2ReferenceNode - ComfyUI Built-in Node Documentation

> 이 노드는 ByteDance의 Seedance 2.5 또는 Seedance 2.0 AI 모델을 사용하여 비디오를 생성, 편집 또는 확장합니다. 텍스트 프롬프트로 비디오를 설명하고 참조 이미지, 비디오 및 오디오를 첨부하여 결과를 유도할 수 있으며, 멀티모달 참조, 비디오 편집 및 비디오 확장을 지원합니다. 이것은 Seed

이 노드는 ByteDance의 Seedance 2.5 또는 Seedance 2.0 AI 모델을 사용하여 비디오를 생성, 편집 또는 확장합니다. 텍스트 프롬프트로 비디오를 설명하고 참조 이미지, 비디오 및 오디오를 첨부하여 결과를 유도할 수 있으며, 멀티모달 참조, 비디오 편집 및 비디오 확장을 지원합니다. 이것은 Seedance reference-to-video 노드의 레거시(더 이상 사용되지 않는) 버전입니다.

## 입력

`model`을 선택하면 아래 매개변수 중 사용할 수 있는 항목이 결정됩니다. `video_editing` 및 `output_format`은 Seedance 2.5를 선택한 경우에만 나타납니다. 확장 가능한 참조 슬롯과 참조 비디오 자동 크기 조정 옵션은 모든 모델에서 공유되며 참조 입력 아래에 설명되어 있습니다.

### 공통 입력

| 매개변수        | 설명                                                                                                                                                                                             | 데이터 타입         | 필수 | 범위                                                                                           |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | -- | -------------------------------------------------------------------------------------------- |
| `model`     | 비디오 생성에 사용할 AI 모델입니다. Seedance 2.5는 최신 모델로, 최대 30초 비디오와 mp4/mov 출력을 지원합니다. Seedance 2.0은 최대 품질과 4k를 위한 모델입니다. Fast는 속도 최적화용입니다. Mini는 가장 빠르고 비용이 가장 낮은 생성용입니다. 모델을 선택하면 아래에 나열된 모델별 입력이 표시됩니다. | DYNAMIC\_COMBO | 예  | `"Seedance 2.5"`<br />`"Seedance 2.0"`<br />`"Seedance 2.0 Fast"`<br />`"Seedance 2.0 Mini"` |
| `seed`      | `seed`는 노드를 다시 실행할지 여부를 제어합니다. 시드와 관계없이 결과는 비결정적입니다(기본값: 0).                                                                                                                                   | INT            | 예  | 0 \~ 2147483647<br />단계: 1                                                                   |
| `watermark` | 비디오에 워터마크를 추가할지 여부입니다(기본값: False). 고급 설정입니다.                                                                                                                                                   | BOOLEAN        | 예  | `True`<br />`False`                                                                          |

### Seedance 2.5 입력

| 매개변수             | 설명                                                                                                                                                                              | 데이터 타입  | 필수 | 범위                                                                                            |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | -- | --------------------------------------------------------------------------------------------- |
| `prompt`         | 비디오 생성을 위한 텍스트 프롬프트입니다. 생성된 대사를 유도하려면 대사를 큰따옴표로 묶으세요. 공백이 아닌 문자를 최소 하나 이상 포함해야 합니다(기본값: 비어 있음).                                                                                 | STRING  | 예  | Any text                                                                                      |
| `resolution`     | 출력 비디오의 해상도입니다(기본값: `"720p"`).                                                                                                                                                  | COMBO   | 예  | `"480p"`<br />`"720p"`<br />`"1080p"`                                                         |
| `ratio`          | 출력 비디오의 화면 비율입니다(기본값: `"16:9"`).                                                                                                                                                | COMBO   | 예  | `"16:9"`<br />`"4:3"`<br />`"1:1"`<br />`"3:4"`<br />`"9:16"`<br />`"21:9"`<br />`"adaptive"` |
| `duration`       | 출력 비디오의 길이(초)입니다(기본값: 5).                                                                                                                                                       | INT     | 예  | 4 \~ 30<br />단계: 1                                                                            |
| `generate_audio` | 출력 비디오에 대한 오디오 생성을 활성화합니다(기본값: True).                                                                                                                                           | BOOLEAN | 예  | `True`<br />`False`                                                                           |
| `video_editing`  | 프롬프트가 연결된 참조 비디오를 편집하는 경우(예: 비디오 내 객체 교체) 활성화합니다. 그러면 출력은 원본 클립 자체의 길이와 화면 비율을 유지하며, `duration` 및 `ratio` 위젯은 무시됩니다. 새 비디오를 생성하거나 설정한 길이로 비디오를 확장하려면 비활성화된 상태로 두세요(기본값: False). | BOOLEAN | 예  | `True`<br />`False`                                                                           |
| `output_format`  | 출력 비디오의 컨테이너 형식입니다(기본값: `"mp4"`).                                                                                                                                               | COMBO   | 예  | `"mp4"`                                                                                       |

### Seedance 2.0 입력

| 매개변수             | 설명                                                                | 데이터 타입  | 필수 | 범위                                                                                            |
| ---------------- | ----------------------------------------------------------------- | ------- | -- | --------------------------------------------------------------------------------------------- |
| `prompt`         | 비디오 생성을 위한 텍스트 프롬프트입니다. 공백이 아닌 문자를 최소 하나 이상 포함해야 합니다(기본값: 비어 있음). | STRING  | 예  | Any text                                                                                      |
| `resolution`     | 출력 비디오의 해상도입니다.                                                   | COMBO   | 예  | `"480p"`<br />`"720p"`<br />`"1080p"`<br />`"4k"`                                             |
| `ratio`          | 출력 비디오의 화면 비율입니다(기본값: `"adaptive"`).                              | COMBO   | 예  | `"16:9"`<br />`"4:3"`<br />`"1:1"`<br />`"3:4"`<br />`"9:16"`<br />`"21:9"`<br />`"adaptive"` |
| `duration`       | 출력 비디오의 길이(초)입니다(기본값: 7).                                         | INT     | 예  | 4 \~ 15<br />단계: 1                                                                            |
| `generate_audio` | 출력 비디오에 대한 오디오 생성을 활성화합니다(기본값: True).                             | BOOLEAN | 예  | `True`<br />`False`                                                                           |

### Seedance 2.0 Fast 및 Seedance 2.0 Mini 입력

Seedance 2.0 Fast 및 Seedance 2.0 Mini에서 공유됩니다. 이 두 모델은 `resolution`이 480p 및 720p로 제한되는 점을 제외하면 Seedance 2.0과 동일한 입력 세트를 제공합니다.

| 매개변수             | 설명                                                                | 데이터 타입  | 필수 | 범위                                                                                            |
| ---------------- | ----------------------------------------------------------------- | ------- | -- | --------------------------------------------------------------------------------------------- |
| `prompt`         | 비디오 생성을 위한 텍스트 프롬프트입니다. 공백이 아닌 문자를 최소 하나 이상 포함해야 합니다(기본값: 비어 있음). | STRING  | 예  | Any text                                                                                      |
| `resolution`     | 출력 비디오의 해상도입니다.                                                   | COMBO   | 예  | `"480p"`<br />`"720p"`                                                                        |
| `ratio`          | 출력 비디오의 화면 비율입니다(기본값: `"adaptive"`).                              | COMBO   | 예  | `"16:9"`<br />`"4:3"`<br />`"1:1"`<br />`"3:4"`<br />`"9:16"`<br />`"21:9"`<br />`"adaptive"` |
| `duration`       | 출력 비디오의 길이(초)입니다(기본값: 7).                                         | INT     | 예  | 4 \~ 15<br />단계: 1                                                                            |
| `generate_audio` | 출력 비디오에 대한 오디오 생성을 활성화합니다(기본값: True).                             | BOOLEAN | 예  | `True`<br />`False`                                                                           |

### 참조 입력

모든 모델에서 사용할 수 있습니다. 최대 슬롯 수는 선택한 모델에 따라 다릅니다. Seedance 2.5는 Seedance 2.0 모델보다 더 많은 참조를 지원합니다.

| 매개변수               | 설명                                                                                                                                                                                                                           | 데이터 타입  | 필수  | 범위                                               |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | --- | ------------------------------------------------ |
| `reference_images` | 확장 가능한 슬롯: 비디오 생성을 유도하는 하나 이상의 참조 이미지(`image_1`, `image_2`, ...)를 연결합니다. 이미지는 최대 변이 6000픽셀이 되도록 자동 축소되며, 최소 300x300픽셀이고 화면 비율이 0.4에서 2.5 사이여야 합니다.                                                                           | IMAGE   | 아니요 | 최대 30 (Seedance 2.5)<br />최대 9 (Seedance 2.0 모델) |
| `reference_videos` | 확장 가능한 슬롯: 비디오 생성을 유도하는 하나 이상의 참조 비디오(`video_1`, `video_2`, ...)를 연결합니다. 비디오 편집 및 확장에 사용됩니다.                                                                                                                                 | VIDEO   | 아니요 | 최대 10 (Seedance 2.5)<br />최대 3 (Seedance 2.0 모델) |
| `reference_audios` | 확장 가능한 슬롯: 비디오 생성을 유도하는 하나 이상의 참조 오디오 클립(`audio_1`, `audio_2`, ...)을 연결합니다.                                                                                                                                                  | AUDIO   | 아니요 | 최대 10 (Seedance 2.5)<br />최대 3 (Seedance 2.0 모델) |
| `auto_downscale`   | 선택한 해상도에 대해 모델의 픽셀 예산을 초과하는 참조 비디오를 자동으로 축소합니다. 화면 비율은 유지되며, 이미 제한 내에 있는 비디오는 변경되지 않습니다(기본값: True).                                                                                                                          | BOOLEAN | 아니요 | `True`<br />`False`                              |
| `auto_upscale`     | 고급 설정입니다. 선택한 해상도에 대해 모델의 최소 픽셀 수 미만인 참조 비디오를 자동으로 확대합니다. 화면 비율은 유지되며, 이미 최소 기준을 충족하는 비디오는 변경되지 않습니다. 참고: 저해상도 소스를 업스케일해도 실제 디테일이 추가되지 않으며 더 낮은 품질의 생성 결과가 나올 수 있습니다(기본값: False).                                            | BOOLEAN | 아니요 | `True`<br />`False`                              |
| `reference_assets` | 확장 가능한 슬롯: 참조로 사용할 이전에 생성된 Seedance 가상 라이브러리 에셋(Image, Video 또는 Audio)의 ID입니다(`asset_1`, `asset_2`, ...). 각 에셋은 존재해야 하며 Active 상태여야 합니다. 프롬프트에서 에셋은 `asset1`, `asset 1` 등으로 참조할 수 있으며, 노드는 이러한 토큰을 "Image 2"와 같은 레이블로 대체합니다. | STRING  | 아니요 | 최대 30 (Seedance 2.5)<br />최대 9 (Seedance 2.0 모델) |

**중요 제약 사항:**

* 참조는 최소 하나 이상 필요합니다. Seedance 2.0, 2.0 Fast 및 2.0 Mini의 경우, 최소 하나의 이미지 또는 비디오 참조를 제공해야 합니다(`reference_images`, `reference_videos` 또는 `reference_assets`의 이미지 또는 비디오 항목을 통해). Seedance 2.5는 추가로 오디오 전용 참조를 허용합니다(`reference_audios` 또는 오디오 `reference_assets` 항목을 통해).
* 참조 개수는 모델에 따라 다르며, 직접 입력과 에셋 참조를 합산하여 검증됩니다. Seedance 2.5는 최대 30개의 `reference_images`, 10개의 `reference_videos`, 10개의 `reference_audios`, 30개의 `reference_assets`를 허용합니다. Seedance 2.0 모델은 최대 9개의 이미지, 3개의 비디오, 3개의 오디오 클립, 9개의 에셋을 허용합니다.
* 각 참조 비디오는 최소 1.8초 길이여야 하며, 각 참조 오디오 클립도 최소 1.8초 길이여야 합니다. 모든 참조 비디오의 총 길이와 모든 참조 오디오의 총 길이는 선택한 모델의 제한(Seedance 2.0 모델의 경우 15.1초) 내에 있어야 합니다.
* 참조 비디오는 또한 선택한 해상도에 대한 모델의 픽셀 수 제한을 충족해야 합니다. `auto_downscale`이 활성화된 경우(기본값), 크기가 초과된 비디오는 자동으로 크기 조정됩니다. `auto_upscale`이 활성화된 경우, 크기가 부족한 비디오는 확대됩니다. 두 자동 조정 중 하나라도 비활성화되어 있으면 해당 제한을 벗어난 비디오는 오류를 발생시킵니다.
* Seedance 2.5에서 `video_editing`이 활성화되면 `duration` 및 `ratio` 입력은 무시되며, 출력은 참조 비디오 자체의 길이와 화면 비율과 일치합니다. 제공자가 프롬프트를 참조 비디오 편집으로 해석하는 경우, `video_editing`이 활성화되어 있지 않거나 새 비디오를 설명하도록 프롬프트를 다시 작성하지 않으면 생성이 실패합니다.
* 제공자가 비디오용으로 생성된 오디오 트랙을 거부하는 경우(예: 저작권 일치 가능성), 작업이 실패합니다. `generate_audio`를 비활성화하면 무음 비디오가 생성됩니다.

## 출력

| 출력 이름   | 설명             | 데이터 타입 |
| ------- | -------------- | ------ |
| `video` | 생성된 비디오 파일입니다. | VIDEO  |

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

***

**Source fingerprint (SHA-256):** `4a1b62f65ff3515cdb749c9b3916e631e53523fe144e8cdf71ca020825196ae6`