wuwukaka/ComfyUI-WanAnimatePlus

ComfyUI‑WanAnimatePlus

무엇인가요 – ComfyUI의 커스텀 노드 모음으로, WanVideo 파이프라인을 확장합니다. 다중 참조 이미지 삽입, 시ーム리스한 비디오 연결, 그리고 최신 SCAIL‑2 및 Bernini 비디오 생성 모델의 완전한 지원을 추가합니다.

왜 중요한가요 – 원래 WanVideo 워크플로우는 단일 참조 이미지만 허용했으며, 여러 생성 실행 간에 비디오를 쉽게 연속할 수 없었습니다. WanAnimatePlus는 이러한 제한을 해결하여 다음을 가능하게 합니다:

• 최대 5개의 참조 이미지로 생성을 안내합니다 (prefix_frames).
• 이전 세그먼트의 마지막 21프레임을 입력하여 연속된 비디오 세그먼트를 시각적인 절단 없이 연결합니다 (transition_video).
• Bernini 모델을 비디오 → 비디오, 참조 비디오 → 비디오, 참조 이미지 → 비디오, 텍스트 → 비디오 작업에 사용합니다.
• SCAIL‑2 체크포인트와 함께 작동하며, 참조 이미지, 포즈 스트림, 마스크, 배경 이미지, 두 단계 샘플링을 전용 노드를 통해 처리합니다.

주요 기능

기능	기능 설명
prefix_frames	1~5개의 추가 참조 이미지를 수락합니다. 노드는 캔버스를 확장하고, 이미지를 인코딩하며, 자동으로 포즈/얼굴 오프셋을 정렬합니다.
transition_video	이전 클립의 마지막 21프레임을 가져와 생성 캔버스 앞부분에 기록하고, 디코딩 후에 잘라내어 시ーム리스한 전달을 구현합니다.
Bernini 지원	소스 비디오, 참조 비디오 또는 참조 이미지에서 조건 레이턴스를 생성하며, 자동으로 작업 유형(v2v, rv2v, r2v, t2v)을 감지합니다.
SCAIL‑2 임베딩	참조 이미지, 드라이브 포즈, 색상 포즈 마스크, 선택적 프리픽스/트랜지션 레이턴스, 배경 이미지를 SCAIL‑2 모델이 기대하는 형식으로 사전 처리합니다.
공식 호환 흐름 노드	WanAnimatePlus SCAIL_2 Flow Embeds, Flow Sampler, VAE Decode는 일반 ComfyUI와 동일한 MODEL / VAE / CONDITIONING / LATENT / IMAGE 인터페이스를 노출하여, SCAIL‑2 워크플로우를 표준 노드 연결로 구축할 수 있습니다.
쉬운 샘플러 노드	WanAnimatePlus Easy Sampler와 Easy SamplerSettings는 많은 저수준 샘플러 인수를 숨기면서도 내부적으로 완전한 WanAnimatePlus 샘플러를 사용합니다.
메모리 도우미	force_offload 및 tiled_vae와 같은 옵션을 통해 보통 GPU에서도 무거운 비디오 모델을 실행할 수 있습니다.

일반적인 사용 사례

• 여러 시각적 참조를 사용하여 긴 일관성 있는 비디오 시퀀스 생성 (예: 캐릭터가 여러 자세로 등장).
• 기존 클립을 연장하기 (예: 애니메이션을 계속하거나 비디오 끝부분을 편집).
• 소스 비디오의 움직임을 새로운 주제에 전달하면서 참조 이미지도 삽입하기.
• SCAIL‑2 모델을 사용하여 선택적 배경 교체를 포함한 고품질 포즈 기반 애니메이션 생성.

설치

# ComfyUI 설치 내부에서
cd ComfyUI/custom_nodes
git clone https://github.com/wuwukaka/ComfyUI-WanAnimatePlus.git
# 새로운 노드가 등록되도록 ComfyUI를 재시작

README는 원래 ComfyUI‑WanVideoWrapper도 설치해야 한다고 언급하지만, 동일한 워크플로우에서 WanAnimatePlus 노드와 원래 WanVideo 노드를 혼용하지 마세요.

빠른 시작 워크플로우

1. ComfyUI를 엽니다. 새로운 카테고리 WanAnimatePlus가 나타납니다.
2. 표준 WanVideo 체인을 WanAnimatePlus의 동등물로 교체합니다:
   • WanAnimatePlus ModelLoader
   • WanAnimatePlus VAELoader
   • WanAnimatePlus ContextOptions
   • WanAnimatePlus AnimateEmbeds (이제 prefix_frames 및 transition_video 입력이 있음)
   • WanAnimatePlus Sampler / Easy Sampler
   • WanAnimatePlus Decode
3. 선택적 입력을 연결합니다:
   • 프리픽스 프레임 – 최대 5개의 참조 이미지.
   • 트랜지션 비디오 – 이전 세그먼트의 마지막 21프레임.
   • SCAIL‑2용: 포즈 이미지, 마스크 등과 함께 WanAnimatePlus SCAIL_2 Embeds (또는 흐름 버전) 사용.
4. 워크플로우를 실행합니다. 트랜지션 클립을 제공한 경우, 출력 비디오는 앞부분에 추가된 프레임이 잘려나가며 매끄러운 연속이 됩니다.

예제 리소스

• example_workflows/ – 다중 참조 생성, 비디오 연속, SCAIL‑2 사용을 보여주는 미리 준비된 JSON 워크플로우.
• README에 있는 RunningHub 링크를 통해 무료 클라우드 인스턴스에서 워크플로우를 시도할 수 있습니다 (초대 코드로 1,000 크레딧을 받을 수 있음).

프로젝트 구조 – 리포지토리는 일반적인 ComfyUI 커스텀 노드 구조를 반영합니다: 핵심 노드 정의 (nodes.py, nodes_sampler.py), 모델 로딩 헬퍼, 컨텍스트 윈도우 스케줄링, 유틸리티 모듈. 모든 중량 작업은 wanvideo/ 하위 디렉터리에 있으며, 원래 WanVideo 코드의 포크입니다.

라이선스 및 출처 – Apache‑2.0, 상류의 ComfyUI‑WanVideoWrapper 및 기타 도우미 프로젝트에 대한 출처를 포함한 NOTICE 파일이 있습니다.

---

결론 – 이미 ComfyUI를 사용해 비디오 생성을 하고 있으며, 다중 참조 제어나 시ーム리스 연결이 필요하다면, WanAnimatePlus는 WanVideo 파이프라인을 확장하는 즉시 사용 가능한 노드 세트를 제공하며 공식 ComfyUI 노드 생태계와 호환됩니다.