音视频#音乐生成

YuE2:先写可编辑乐谱,再生成带人声的歌曲

YuE2 是开源音乐生成模型,先出可编辑的乐谱再渲染人声与伴奏,适合改编旋律、换和声的创作者;代码 Apache-2.0,权重 CC BY-NC 4.0。

项目资料

GitHub Ecosystem
仓库地址github.com/multimodal-art-projection/YuE
许可证
Apache-2.0
主语言
Python
星标
12,278
核查时间
2026-10-19

以上快照资料以核查当日为准,可能随版本或运营策略变化。

YuE2 架构图:风格与歌词先写成 ABC 乐谱,再经语义 token、声学潜变量和 VAE 解码器生成 48 kHz 音频

YuE2 是一个开源音乐生成模型,作者来自 M-A-P(Multimodal Art Projection)、香港科技大学、斯坦福大学等机构。给它歌词和风格描述,它先写出一份带旋律和和弦的乐谱,再渲染成带人声与伴奏的歌曲。GitHub 仓库 multimodal-art-projection/YuE 创建于 2025 年 1 月,现在主推的是 YuE2;截至 2026 年 10 月 19 日,仓库有 12,278 颗星。公众号「逛逛 GitHub」最近推荐过它。

YuE2 架构图:风格与歌词先写成 ABC 乐谱,再经语义 token、声学潜变量和 VAE 解码器生成 48 kHz 音频

图中最关键的是左上角的 ABC 乐谱。它是音频生成之前的一层符号表示,人可以读、可以改,智能体也可以改,然后才进入声学生成。

核心功能

  • 先出乐谱,再出声音:默认模式(cot="full")先生成带旋律和和弦的乐谱。可以用 abc=... 传入自己的乐谱,也可以导出 score.abc,改完后重新渲染。
  • 翻唱:先用 SheetSage2 把录音转写成旋律乐谱,再给出新歌词和新风格。README 建议翻唱时用 cot="melody",并且乐谱里不带和弦符号,让伴奏能跟着新风格变化。
  • 对话式编辑:README 的示例把《The Last Train》分 9 步、改成 14 个版本,从普通话流行改到英文爵士,中间加入了新的和声和萨克斯独奏。每个版本都能听,也能看到对话、乐谱和歌词。
  • 两段式生成结构:一个 AR–NAR 混合 Transformer 先自回归地预测乐谱和语义 token,再用 flow matching 生成声学潜变量,最后由 VAE 解码成 48 kHz 立体声。
  • 配套工具:SheetSage2 负责音频转乐谱,MERT2 提供音乐表征。仓库里的 skills/yue2-music 是给智能体用的技能,覆盖生成歌曲与纯音乐、翻唱和 ABC 乐谱编辑。

典型使用场景

  • 手里有歌词、想先看旋律的创作者:生成前就能看到乐谱,觉得和弦不合适,可以先改和声再渲染。
  • 想改编老歌或录音的人:保留原来的旋律,换成另一种风格。README 的示例里,中文流行被改成了英文爵士。
  • 做音乐研究或评测的人:仓库给出了 WildSongBench 的评测入口和 SheetSage2 的论文,可以拿作者的数字去对照复现。
  • 想把成品发到流媒体平台的创作者:YouTube Music 从 10 月 14 日起给 AI 生成或改写的歌曲加上“Made with AI”标签,发布前先看平台规则。详见 YouTube Music 的 AI 标签。

性能数据

YuE2 的数字来自作者在 WildSongBench 上的自动评测,共 192 条提示,测试日期是 2026 年 9 月 12 日。下表摘自 README,我们没有独立复现。

系统 / 设置SongBench Avg ↑AudioBox PQ ↑MuLan ↑PER ↓
YuE2(best-of-8)6.96328.27140.50519.79%
Suno v56.87218.16980.54288.10%
YuE2(标准)6.73168.25980.50688.44%
Suno v5.56.71508.19550.50895.96%
Suno v66.55628.12960.49167.58%
YuE 14.91657.86830.262336.38%

标准 YuE2 从 2 个候选中选结果,best-of-8 从 8 个候选中选。作者自己也说,前几名之间的差距不足以判断统计显著性。在翻唱上,README 报告在 948 首作品上,带乐谱时 CLEWS mAP 为 0.647,不带乐谱时只有 0.006。

快速上手

YuE2 的安装和首次运行命令都在仓库 README 里,下面是原样复制的版本:

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

我们没有在符合这些条件的机器上实际运行过这些命令。README 写明的运行条件是 Linux、Python 3.12,以及支持 BF16 的 NVIDIA GPU,显存 24 GB。模型文件在首次运行时从 Hugging Face 下载。成功后,outputs/first-song/audio.flac 就是生成的歌曲,同一目录还保存乐谱、语义 token、声学潜变量和生成参数。

小结

YuE2 适合有 Linux 环境和大显存 NVIDIA 显卡、想让乐谱参与创作的人,也适合做翻唱和音乐研究的人。它不适合想直接在 Mac 或 Windows 上运行的人,因为 README 没有列出这两个平台。公众号文章作者称在 M1 Pro 笔记本上生成过约 20 秒的音频,但那不在官方支持范围内。

许可证要分开看。代码、文档和智能体技能是 Apache-2.0。模型权重是 CC BY-NC 4.0,但附加的创作者许可允许个人创作者和音乐人免费使用权重,并可以销售或授权生成的作品,不需要向作者支付费用,但要遵守负责任使用条款。企业商用需要联系作者申请商业许可。

另外两点需要注意。性能数字是作者自报的,我们没有复现。搜索 YuE2 时还会看到几个名字相近、README 没有列出的第三方站点和仓库,本文只以官方仓库、README 和 Hugging Face 模型页为准。仓库最近一次推送是 2026 年 10 月 6 日,语言为 Python。