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

# WanAnimateToVideo - ComfyUI Built-in Node Documentation

> Complete documentation for the WanAnimateToVideo node in ComfyUI. Learn its inputs, outputs, parameters and usage.

# WanAnimateToVideo 노드

WanAnimateToVideo 노드는 포즈 참조, 표정, 배경 요소를 포함한 여러 조건 입력을 결합하여 비디오 콘텐츠를 생성합니다. 다양한 비디오 입력을 처리하여 일관된 애니메이션 시퀀스를 만들며, 프레임 간 시간적 일관성을 유지합니다. 이 노드는 잠재 공간 연산을 처리하며, 모션 패턴을 지속하여 기존 비디오를 확장할 수 있습니다.

## 입력

| 매개변수             | 설명                                                                                                                     | 데이터 타입               | 필수  | 범위                    |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------- | -------------------- | --- | --------------------- |
| `긍정 프롬프트`        | 원하는 콘텐츠로 생성 방향을 안내하는 긍정 조건                                                                                             | CONDITIONING         | 예   | -                     |
| `부정 프롬프트`        | 원하지 않는 콘텐츠에서 생성 방향을 멀어지게 하는 부정 조건                                                                                      | CONDITIONING         | 예   | -                     |
| `VAE`            | 이미지 데이터 인코딩 및 디코딩에 사용되는 VAE 모델                                                                                         | VAE                  | 예   | -                     |
| `너비`             | 출력 비디오 가로 픽셀 (기본값: 832, 단계: 16)                                                                                        | INT                  | 예   | 16 \~ MAX\_RESOLUTION |
| `높이`             | 출력 비디오 세로 픽셀 (기본값: 480, 단계: 16)                                                                                        | INT                  | 예   | 16 \~ MAX\_RESOLUTION |
| `길이`             | 생성할 프레임 수 (기본값: 77, 단계: 4)                                                                                             | INT                  | 예   | 1 \~ MAX\_RESOLUTION  |
| `배치 크기`          | 동시에 생성할 비디오 수 (기본값: 1)                                                                                                 | INT                  | 예   | 1 \~ 4096             |
| `클립 비전 출력`       | 추가 조건을 위한 선택적 CLIP 비전 모델 출력                                                                                            | CLIP\_VISION\_OUTPUT | 아니요 | -                     |
| `참조 이미지`         | 생성 시작점으로 사용되는 참조 이미지                                                                                                   | IMAGE                | 아니요 | -                     |
| `얼굴 비디오`         | 표정 안내를 제공하는 비디오 입력                                                                                                     | IMAGE                | 아니요 | -                     |
| `포즈 비디오`         | 포즈 및 동작 안내를 제공하는 비디오 입력                                                                                                | IMAGE                | 아니요 | -                     |
| `연속 모션 최대 프레임 수` | 이전 동작에서 이어갈 최대 프레임 수 (기본값: 5, 단계: 4)                                                                                   | INT                  | 예   | 1 \~ MAX\_RESOLUTION  |
| `배경 비디오`         | 생성된 콘텐츠와 합성할 배경 비디오                                                                                                    | IMAGE                | 아니요 | -                     |
| `캐릭터 마스크`        | 선택적 처리를 위한 캐릭터 영역을 정의하는 마스크                                                                                            | MASK                 | 아니요 | -                     |
| `연속 모션`          | 시간적 일관성을 위해 이어갈 이전 동작 시퀀스                                                                                              | IMAGE                | 아니요 | -                     |
| `비디오 프레임 오프셋`    | 모든 입력 비디오에서 탐색할 프레임 양. 청크 단위로 더 긴 비디오를 생성하는 데 사용됩니다. 비디오 확장을 위해 이전 노드의 video\_frame\_offset 출력에 연결하세요. (기본값: 0, 단계: 1) | INT                  | 예   | 0 \~ MAX\_RESOLUTION  |

**매개변수 제약 조건:**

* `pose_video`가 제공되고 `trim_to_pose_video` 로직이 활성화된 경우(현재 소스 코드에서 `False`로 설정됨), 출력 길이는 포즈 비디오 길이에 맞게 조정됩니다
* `face_video`는 처리 시 자동으로 512x512 해상도로 크기가 조정되고 -1.0에서 1.0 범위로 정규화됩니다
* `continue_motion` 프레임은 `continue_motion_max_frames` 매개변수에 의해 제한되며, 입력의 마지막 `continue_motion_max_frames` 프레임만 사용됩니다
* 입력 비디오(`face_video`, `pose_video`, `background_video`, `character_mask`)는 처리 전에 `video_frame_offset`만큼 오프셋됩니다. 오프셋이 비디오 길이를 초과하면 입력이 무시됩니다
* `character_mask`에 프레임이 하나만 포함된 경우 모든 프레임에 반복 적용됩니다
* `clip_vision_output`이 제공되면 긍정 및 부정 조건 모두에 적용됩니다
* `reference_image`가 제공되지 않으면 검은색 이미지(모두 0)가 기본 참조로 사용됩니다
* `continue_motion`이 제공되지 않으면 초기 프레임이 회색(0.5 강도) 노이즈로 채워집니다

## 출력

| 출력 이름         | 설명                                                                                                          | 데이터 타입       |
| ------------- | ----------------------------------------------------------------------------------------------------------- | ------------ |
| `부정 프롬프트`     | CLIP 비전 출력, 포즈 비디오 잠재, 얼굴 비디오 픽셀, 연결된 잠재 이미지 및 연결된 마스크를 포함한 추가 비디오 컨텍스트가 적용된 수정된 긍정 조건                      | CONDITIONING |
| `잠재 공간`       | CLIP 비전 출력, 포즈 비디오 잠재, 얼굴 비디오 픽셀(반전), 연결된 잠재 이미지 및 연결된 마스크를 포함한 추가 비디오 컨텍스트가 적용된 수정된 부정 조건                  | CONDITIONING |
| `잠재 공간 트리밍`   | \[batch\_size, 16, latent\_length + trim\_latent, latent\_height, latent\_width] 형태의 잠재 공간 형식으로 생성된 비디오 콘텐츠 | LATENT       |
| `이미지 트리밍`     | 시작 부분에서 제거할 잠재 프레임 수를 나타내는 잠재 공간 트리밍 정보 (참조 이미지 잠재 프레임에 해당)                                                 | INT          |
| `비디오 프레임 오프셋` | 참조 모션 프레임에 대한 이미지 공간 트리밍 정보로, 시작 부분에서 제거할 이미지 프레임 수를 나타냅니다                                                  | INT          |
| `비디오 프레임 오프셋` | 청크 단위로 비디오 생성을 계속하기 위한 업데이트된 프레임 오프셋으로, 이전 오프셋에 생성된 길이를 더하여 계산됩니다                                           | INT          |

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

***

**Source fingerprint (SHA-256):** `c2ca90f4963f629d51cdd7f4bdb67e01c32ce5ca7d916b1f992ccd220f57566c`
