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에서 편집

---

Source fingerprint (SHA-256): c2ca90f4963f629d51cdd7f4bdb67e01c32ce5ca7d916b1f992ccd220f57566c