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

# Wan Dancer: 음악에서 춤 비디오 생성

> Wan Dancer를 사용하여 음악에서 분 단위의 일관된 춤 비디오를 생성하세요. Wan Dancer는 Wan 2.2를 기반으로 구축된 계층적 오디오 기반 프레임워크입니다. 참조 이미지와 오디오를 입력하여 동기화된 춤 비디오를 생성합니다.

Wan Dancer는 Wan 2.2 아키텍처를 기반으로 구축된 오디오 기반 댄스 비디오 생성 모델입니다. 글로벌 및 로컬 전문가 모델을 포함하는 계층적 프레임워크를 사용하여 입력 음악에 동기화된 일관되고 표현력 있는 댄스 비디오를 생성합니다.

캐릭터의 참조 이미지와 오디오 트랙이 주어지면 Wan Dancer는 캐릭터가 음악의 리듬과 스타일에 맞는 움직임을 수행하는 댄스 비디오를 생성합니다. 글로벌 모델은 전반적인 댄스 구조와 신체 조정을 캡처하고, 로컬 모델은 자연스럽고 고품질의 출력을 위해 세밀한 동작 세부 정보를 다듬습니다.

## 모델 하이라이트

* **오디오 기반 댄스 생성**: 수동 키프레임이나 모션 캡처 없이 음악에서 직접 춤 동작을 생성합니다.
* **계층적 프레임워크**: 일관된 신체 동작과 세부 움직임 정제를 위한 2단계 아키텍처(글로벌 및 로컬)
* **음악 동기화 출력**: 춤 동작이 입력 오디오의 리듬과 템포에 자연스럽게 정렬됩니다.
* **스타일 제어**: 구성 가능한 춤 스타일과 동작 강도로 창의적 방향 설정
* **분 단위 생성**: 긴 형식의 일관된 춤 비디오를 생성하여 전체 시간에 걸쳐 시간적 일관성 유지

## 워크플로우 개요

Wan Dancer 워크플로는 두 가지 입력(캐릭터의 참조 이미지와 오디오 파일)을 받아들입니다. 두 개의 비디오 출력을 생성합니다: 전반적인 춤 구조를 보여주는 글로벌 출력 미리보기와 향상된 동작 세부 정보가 있는 최종 정제된 출력입니다.

<Tip>
  <Tabs>
    <Tab title="휴대용 또는 자체 배포 사용자">
      ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.

      * [ComfyUI 다운로드](https://www.comfy.org/download)
      * [업데이트 가이드](/ko/installation/update_comfyui)

      이 가이드의 워크플로우는 [워크플로우 템플릿](/ko/interface/features/template)에서 확인할 수 있습니다.
      템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다. (데스크톱 버전의 업데이트는 다소 지연될 수 있습니다)

      워크플로우를 로드할 때 노드가 누락되는 경우, 가능한 원인:

      1. 최신 ComfyUI 버전(야간 빌드)을 사용하고 있지 않음
      2. 일부 노드가 시작 시 가져오기에 실패함
    </Tab>

    <Tab title="데스크톱 또는 클라우드 사용자">
      * 데스크톱 버전은 ComfyUI 안정판 기반으로, 새로운 데스크톱 안정판이 출시되면 자동으로 업데이트됩니다.
      * [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.

      따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.
    </Tab>
  </Tabs>
</Tip>

## Wan Dancer 워크플로

### 1. 워크플로 파일 다운로드

ComfyUI를 최신 버전으로 업데이트한 후 워크플로 파일을 다운로드하여 ComfyUI로 드래그하거나, 템플릿 라이브러리에서 `워크플로` → `템플릿 탐색` → `비디오`로 이동하여 "Wan Dancer"를 찾으세요.

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=video_wan_dancer&utm_source=docs&utm_medium=referral&utm_campaign=wan-dancer">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_wan_dancer.json">
    JSON 다운로드 또는 템플릿 라이브러리에서 "Wan Dancer" 검색
  </Card>
</CardGroup>

### 2. 입력 자료 다운로드

<CardGroup cols={2}>
  <Card title="참조 이미지: blue_dancer.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/blue_dancer.png">
    댄스 생성을 위한 입력 캐릭터 이미지. 이 이미지를 다운로드하여 사용하거나 자신의 이미지로 교체하세요.
  </Card>

  <Card title="참조 오디오" icon="music" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/wan_dancer_reference_audio.mp3">
    댄스 동기화를 위한 참조 오디오 트랙. 이 오디오를 다운로드하여 사용하거나 자신의 음악으로 교체하세요.
  </Card>
</CardGroup>

### 3. 모델 수동 다운로드

**확산 모델**

* [wan2.2\_dancer\_14b\_global\_fp8\_scaled.safetensors](https://huggingface.co/Comfy-Org/Wan-Dancer/resolve/main/diffusion_models/wan2.2_dancer_14b_global_fp8_scaled.safetensors)
* [wan2.2\_dancer\_14b\_local\_fp8\_scaled.safetensors](https://huggingface.co/Comfy-Org/Wan-Dancer/resolve/main/diffusion_models/wan2.2_dancer_14b_local_fp8_scaled.safetensors)

**LoRA**

* [lightx2v\_I2V\_14B\_480p\_cfg\_step\_distill\_rank64\_bf16.safetensors](https://huggingface.co/Kijai/WanVideo_comfy/resolve/main/Lightx2v/lightx2v_I2V_14B_480p_cfg_step_distill_rank64_bf16.safetensors)

**텍스트 인코더**

* [umt5\_xxl\_fp16.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/resolve/main/split_files/text_encoders/umt5_xxl_fp16.safetensors)

**CLIP Vision**

* [clip\_vision\_h.safetensors](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/resolve/main/split_files/clip_vision/clip_vision_h.safetensors)

**VAE**

* [Wan2\_1\_VAE\_bf16.safetensors](https://huggingface.co/Kijai/WanVideo_comfy/resolve/main/Wan2_1_VAE_bf16.safetensors)

```
ComfyUI/
├───📂 models/
│   ├───📂 diffusion_models/
│   │   ├─── wan2.2_dancer_14b_global_fp8_scaled.safetensors
│   │   └─── wan2.2_dancer_14b_local_fp8_scaled.safetensors
│   ├───📂 loras/
│   │   └─── lightx2v_I2V_14B_480p_cfg_step_distill_rank64_bf16.safetensors
│   ├───📂 text_encoders/
│   │   └─── umt5_xxl_fp16.safetensors
│   ├───📂 clip_vision/
│   │   └─── clip_vision_h.safetensors
│   └───📂 vae/
│       └── Wan2_1_VAE_bf16.safetensors
```

### 4. 워크플로 사용법

<Tip>
  Wan Dancer는 한 번에 149 프레임을 샘플링하며 상당한 VRAM이 필요합니다. 기본 워크플로는 5초 비디오를 출력합니다. 이 워크플로를 실행하기 전에 충분한 VRAM이 있는 GPU가 있는지 확인하세요.
</Tip>

1. **참조 이미지 불러오기**: `이미지 불러오기` 노드를 사용하여 캐릭터 이미지를 업로드합니다. 기본 입력은 `blue_dancer.png`를 사용합니다.

2. **오디오 파일 불러오기**: `오디오 불러오기` 노드를 사용하여 음악 또는 오디오 트랙을 업로드합니다. 기본 입력은 `wan_dancer_reference_audio.mp3`를 사용합니다.

3. **댄스 파라미터 구성**:
   * `dance_style`: 출력 비디오의 댄스 스타일을 선택합니다.
   * `motion_amplitude`: 댄스 동작의 강도를 제어합니다.
   * `audio_duration`: 입력 오디오의 길이와 일치하도록 설정합니다.
   * `final_duration`: 최종 출력 비디오 길이를 선택합니다.

4. **출력 크기 구성**:
   * `width`와 `height`: 출력 비디오의 해상도를 설정합니다. GPU의 사용 가능한 VRAM에 적합한 값을 선택하세요.

5. **모델 경로 확인**: 모델 선택 위젯이 올바른 모델 파일을 가리키는지 확인하세요.
   * `global_model`: `wan2.2_dancer_14b_global_fp8_scaled.safetensors`를 로드해야 함
   * `local_model`: `wan2.2_dancer_14b_local_fp8_scaled.safetensors`를 로드해야 함
   * `lightning_lora`: `lightx2v_I2V_14B_480p_cfg_step_distill_rank64_bf16.safetensors`를 로드해야 함
   * `clip_vision`: `clip_vision_h.safetensors`를 로드해야 함

6. **생성 실행**: `실행` 버튼을 클릭하거나 단축키 `Ctrl(Cmd) + Enter`를 사용하여 비디오 생성을 실행합니다.

### 5. 출력

워크플로는 두 개의 비디오 출력을 생성합니다.

* **글로벌 출력 미리보기**: 글로벌 모델로 생성된 전체 댄스 구조를 보여줍니다.
* **최종 출력**: 로컬 모델 향상 후 정제된 댄스 비디오입니다.

두 출력 모두 `SaveVideo` 노드를 통해 자동으로 저장됩니다.

## 모델 정보

Wan Dancer는 Apache 2.0 라이선스로 공개된 오픈 소스 모델입니다. 모델 가중치는 Hugging Face에서 확인할 수 있습니다:

* [Comfy-Org/Wan-Dancer](https://huggingface.co/Comfy-Org/Wan-Dancer): Global 및 local diffusion 모델

## 문제 신고

런타임 오류나 예상치 못한 동작이 발생하는 경우:

* ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.
* 모든 필수 모델이 다운로드되어 올바른 디렉토리에 배치되었는지 확인하세요.
* 데스크톱/클라우드 사용자의 경우: 업데이트는 안정적인 릴리스를 따르므로, 최신 테스트 버전(nightly)이 지원하는 모델은 즉시 사용하지 못할 수 있습니다.

문제 신고: [ComfyUI/issues](https://github.com/Comfy-Org/ComfyUI/issues)