> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-feat-openapi-i18n.mintlify.site/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 노드는 포즈 참조, 표정, 배경 요소를 포함한 여러 조건 입력을 결합하여 비디오 콘텐츠를 생성합니다. 다양한 비디오 입력을 처리하여 일관된 애니메이션 시퀀스를 만들며, 프레임 간 시간적 일관성을 유지합니다. 이 노드는 잠재 공간 연산을 처리하며, 모션 패턴을 지속하여 기존 비디오를 확장할 수 있습니다.

## 입력

| 매개변수             | 설명                                                                                                                     | 데이터 타입               | 필수  | 범위                    |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------- | -------------------- | --- | --------------------- |
| `긍정 프롬프트`        | 원하는 콘텐츠로 생성 방향을 안내하는 긍정 조건                                                                                             | 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`
