Wan-AI/Wan-Dancer-14B · Hugging Face

来源：https://huggingface.co/Wan-AI/Wan-Dancer-14B

💜Wan-Dancer (https://humanaigc.github.io/wan-dancer-project/)| 🖥️GitHub (https://github.com/Wan-Video/Wan-Dancer)| 🤗Hugging Face (https://huggingface.co/Wan-AI/Wan-Dancer-14B)| 🤖ModelScope (https://www.modelscope.cn/models/Wan-AI/Wan-Dancer-14B)| 📑论文 (https://arxiv.org/abs/2607.09581)

Wan-Dancer：用于分钟级连贯音乐生成舞蹈的层次化框架 (https://arxiv.org/abs/2607.09581)

https://huggingface.co/Wan-AI/Wan-Dancer-14B#%F0%9F%94%A5-latest-news🔥 最新消息！！

• 2026年7月13日：💃 我们推出了Wan-Dancer (https://humanaigc.github.io/wan-dancer/)，该方法可从音乐生成长时长、高质量且富有节奏感的舞蹈视频，具备全局结构和时间连续性。我们已发布模型权重 (https://huggingface.co/Wan-AI/Wan-Dancer-14B#model-download) 和推理代码 (https://github.com/Wan-Video/Wan-Dancer)。现在您可以在 ModelScope 工作室 (https://www.modelscope.cn/studios/Wan-AI/Wan-Dancer) 或 HuggingFace Space (https://huggingface.co/spaces/Wan-AI/Wan-Dancer) 上试用！

https://huggingface.co/Wan-AI/Wan-Dancer-14B#%F0%9F%93%91-todo-list📑 待办列表

• Wan-Dancer 音乐生成舞蹈
• Wan-Dancer 推理代码
• Wan-Dancer 检查点
• ComfyUI 集成

https://huggingface.co/Wan-AI/Wan-Dancer-14B#run-wan-dancer运行 Wan-Dancer

https://huggingface.co/Wan-AI/Wan-Dancer-14B#installation安装

克隆仓库：

git clone https://github.com/Wan-Video/Wan-Dancer.git cd Wan-Dancer

安装依赖：

`` python -m venv venv_wan_dancer source venv_wan_dancer/bin/activate

以可编辑模式安装包

pip install -e .

安装额外及指定版本的依赖

pip install moviepy loguru librosa pip install https://mirrors.aliyun.com/pytorch-wheels/cu124/torch-2.6.0+cu124-cp310-cp310-linux_x86_64.whl pip install torchvision==0.21.0 pip install diffusers==0.34.0 pip install yunchang==0.5.0 pip install flash_attn==2.6.3 pip install xfuser==0.4.0 pip install transformers==4.46.2 ``

https://huggingface.co/Wan-AI/Wan-Dancer-14B#model-download模型下载

使用 huggingface-cli 下载模型：

pip install "huggingface_hub[cli]" huggingface-cli download Wan-AI/Wan-Dancer-14B --local-dir ./Wan-Dancer-14B

使用 modelscope-cli 下载模型：

pip install modelscope modelscope download Wan-AI/Wan-Dancer-14B --local_dir ./Wan-Dancer-14B

https://huggingface.co/Wan-AI/Wan-Dancer-14B#run-wan-dancer-1运行 Wan-Dancer

Wan-Dancer 可从音乐生成长时长、高质量且富有节奏感的舞蹈视频，具备全局结构和时间连续性。该方法将过程解耦为全局关键帧规划和局部时间精化，利用完整音乐上下文确保长程连贯性。

https://huggingface.co/Wan-AI/Wan-Dancer-14B#1-%F0%9F%8E%AC-generate-global-keyframe-video1. 🎬 生成全局关键帧视频

运行全局阶段脚本：

cd Wan-Dancer ./gen_video_global.sh

https://huggingface.co/Wan-AI/Wan-Dancer-14B#%F0%9F%94%A7-important-parameters🔧 重要参数

https://huggingface.co/Wan-AI/Wan-Dancer-14B#%F0%9F%8C%B0-examples🌰 示例

https://huggingface.co/Wan-AI/Wan-Dancer-14B#2-%F0%9F%8E%A5-generate-final-high-resolution-video2. 🎥 生成最终高分辨率视频

运行局部精化阶段：

cd Wan-Dancer ./gen_video_local.sh

https://huggingface.co/Wan-AI/Wan-Dancer-14B#%F0%9F%94%A7-additional-required-parameters🔧 额外的必需参数

✅ 所有其他参数（seed、image\_path 等）与步骤1相同。

https://huggingface.co/Wan-AI/Wan-Dancer-14B#%F0%9F%8C%B0-examples-1🌰 示例

注意： 对于更长时长的视频，num\_inference\_steps 应设置为更大的值（例如 48）。

https://huggingface.co/Wan-AI/Wan-Dancer-14B#citation引用

如果您的研究中使用了本代码或框架，请引用：

@article{wan-dancer-2026, title={Wan-Dancer: A Hierarchical Framework for Minute-scale Coherent Music-to-Dance Generation}, author={Mingyang Huang, Peng Zhang, Li Hu, Guangyuan Wang, Bang Zhang}, website={https://humanaigc.github.io/wan-dancer/}, url={https://arxiv.org/abs/2607.09581}, year={2026} }

https://huggingface.co/Wan-AI/Wan-Dancer-14B#license-agreement许可证协议

本项目采用 Apache 2.0 许可证授权——详见 LICENSE (https://huggingface.co/Wan-AI/Wan-Dancer-14B/tree/main/LICENSE) 文件。

https://huggingface.co/Wan-AI/Wan-Dancer-14B#acknowledgements致谢

本工作基于并整合了以下开源项目的组件：

1. DiffSynth-Studio (https://github.com/modelscope/DiffSynth-Studio)
2. Wan2.1 (https://github.com/Wan-Video/Wan2.1)