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

# WanVaceToVideo - ComfyUI Built-in Node Documentation

> WanVaceToVideo 노드는 VACE 제어 비디오 생성 모델을 위한 비디오 컨디셔닝 데이터를 준비합니다. 이 노드는 긍정 및 부정 컨디셔닝을 선택적 제어 비디오, 제어 마스크, 참조 이미지와 결합하고, 이를 VAE를 통해 인코딩한 뒤, 업데이트된 컨디셔닝, 빈 잠재 텐서, 트림 값을 출력합니다.

WanVaceToVideo 노드는 VACE 제어 비디오 생성 모델을 위한 비디오 컨디셔닝 데이터를 준비합니다. 이 노드는 긍정 및 부정 컨디셔닝을 선택적 제어 비디오, 제어 마스크, 참조 이미지와 결합하고, 이를 VAE를 통해 인코딩한 뒤, 업데이트된 컨디셔닝, 빈 잠재 텐서, 트림 값을 출력합니다.

## 입력

| 매개변수     | 설명                                                                                            | 데이터 타입       | 필수  | 범위                    |
| -------- | --------------------------------------------------------------------------------------------- | ------------ | --- | --------------------- |
| `긍정 조건`  | 생성을 유도하기 위한 긍정 컨디셔닝 입력                                                                        | CONDITIONING | 예   | -                     |
| `부정 조건`  | 생성을 유도하기 위한 부정 컨디셔닝 입력                                                                        | CONDITIONING | 예   | -                     |
| `vae`    | 이미지 및 비디오 프레임 인코딩에 사용되는 VAE 모델                                                                | VAE          | 예   | -                     |
| `너비`     | 출력 비디오 너비(픽셀) (기본값: 832, 단계: 16)                                                              | INT          | 예   | 16 to MAX\_RESOLUTION |
| `높이`     | 출력 비디오 높이(픽셀) (기본값: 480, 단계: 16)                                                              | INT          | 예   | 16 to MAX\_RESOLUTION |
| `길이`     | 비디오의 프레임 수 (기본값: 81, 단계: 4)                                                                   | INT          | 예   | 1 to MAX\_RESOLUTION  |
| `배치 크기`  | 동시에 생성할 비디오 수 (기본값: 1)                                                                        | INT          | 예   | 1  \~  4096           |
| `강도`     | VACE 제어를 위한 컨디션 강도입니다(기본값: 1.0, 단계: 0.01). 이는 LoRA 강도가 아닙니다. LoRA 가중치는 별도의 LoRA 노드를 통해 적용됩니다. | FLOAT        | 예   | 0.0  \~  1000.0       |
| `제어 비디오` | 제어 컨디셔닝에 사용되는 선택적 입력 비디오입니다. 제공되지 않으면 중립 회색 비디오가 자동으로 생성됩니다.                                  | IMAGE        | 아니요 | -                     |
| `제어 마스크` | 제어 비디오의 어떤 부분이 활성화되는지 결정하는 선택적 마스크입니다. 제공되지 않으면 전체 흰색 마스크가 사용됩니다.                             | MASK         | 아니요 | -                     |
| `참조 이미지` | 추가 컨디셔닝을 위한 선택적 참조 이미지입니다. 제공되면 인코딩되어 잠재 시퀀스 앞에 추가됩니다. 첫 번째 이미지만 사용됩니다.                       | IMAGE        | 아니요 | -                     |

**참고:** `control_video`가 제공되면 `length` 프레임으로 잘리고 지정된 `width`와 `height`로 업스케일됩니다. `length`보다 프레임 수가 적으면 누락된 프레임은 중립 회색(값 0.5)으로 채워집니다. 제공되지 않으면 `length` 프레임의 중립 회색 비디오가 자동으로 생성됩니다. `control_masks`는 지정된 `width`와 `height`로 업스케일되고, `length` 프레임으로 잘리며, 더 짧으면 값 1.0으로 채워집니다. 마스크는 제어 비디오를 비활성 부분과 반응 부분으로 분리하며, 각각 VAE 인코딩되어 채널 차원을 따라 연결됩니다. 마스크는 또한 잠재 해상도로 다운샘플링됩니다. `reference_image`가 제공되면 첫 번째 이미지가 VAE 인코딩되어 잠재 시퀀스 앞에 추가되며, `trim_latent`는 추가된 잠재 프레임 수를 보고합니다. 잠재 프레임 수는 `((length - 1) // 4) + 1`로 계산되며, 잠재 공간 차원은 `height / 8` 및 `width / 8`입니다.

## 출력

| 출력 이름         | 설명                                                                                    | 데이터 타입       |
| ------------- | ------------------------------------------------------------------------------------- | ------------ |
| `positive`    | 비디오 제어 데이터(vace\_frames, vace\_mask, vace\_strength)가 적용된 긍정 컨디셔닝                     | CONDITIONING |
| `negative`    | 비디오 제어 데이터(vace\_frames, vace\_mask, vace\_strength)가 적용된 부정 컨디셔닝                     | CONDITIONING |
| `latent`      | 비디오 생성을 위해 준비된 빈 잠재 텐서로, 형태는 \[batch\_size, 16, latent\_length, height/8, width/8]입니다 | LATENT       |
| `trim_latent` | 참조 이미지가 사용될 때 트림할 잠재 프레임 수이며, 참조 이미지가 제공되지 않으면 0입니다                                   | INT          |

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

***

**Source fingerprint (SHA-256):** `2039b7509ce5b731e9e41d9cd2dad022d4c5004751f571a4cf88c1ba0cae405b`