按运行方式选择下载

资源用途
YuE 官方仓库Python 推理、示例请求、乐谱编辑与源码。
m-a-p/YuE2-3BPython 流程使用的歌曲生成主模型。
m-a-p/YuE2-Vae默认用于生成与试听的音频解码器。
Comfy-Org/YuE2ComfyUI 原生模板使用的模型文件。

YuE2-Vae-legacy 用于复现已公布的基准测试。日常初次生成用当前默认解码器即可。标准生成流程无需单独下载 MERT2。

安装官方 Python 流程

官方文档的起步配置是 Linux、Python 3.12,以及支持 BF16、拥有 24GB 显存的 NVIDIA 显卡。满足前提后,在终端执行:

TERMINAL / FILE
git clone https://github.com/multimodal-art-projection/YuE.git
cd YuE
python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install .
python examples/generate.py --output outputs/first-song

首次运行会从 Hugging Face 下载模型。下载与推理耗时应分开看。这些命令依据官方快速入门整理,本站未在服务器上运行音乐推理测试。

听音频,也检查生成记录

输出音频位于 outputs/first-song/audio.flac。请一并保留目录中的乐谱、参数与中间产物,后续编辑和比较会用到它们。

查看 result.json 中的截断标记。音频能播放,也可能是生成触及 token 上限后留下的不完整结果。修改请求时使用新的输出目录,以免覆盖原始版本。

让代码、权重与教程对应起来

需要复现实验时,固定仓库和模型版本,并记录运行环境。即便随机种子相同,运行库、解码器或采样参数变化也可能影响结果。

初代 YuE 保存在 YuE-v1 分支,它的使用方式与许可不能直接套到 YuE2 上。更习惯图形界面的用户,可以继续看 ComfyUI 指南

资料来源与延伸阅读

内容依据所列文档核对。本站未进行本地音乐推理性能测试。