YuE2-3B

YuE2-3B

把歌词和风格提示词变成带人声和伴奏的完整歌曲，并让你通过乐谱编辑旋律和和弦。这是一个开放的 3.6B 音乐生成模型，支持英文和中文，仅限非商业使用。

由 m-a-p 在 Hugging Face 上制作。这些说明是 Mindket 根据它的模型页面和模型卡写的，模型自己的文件和许可证在 Hugging Face 上。

简介

它是什么：YuE2-3B 是 m-a-p 的开放音乐生成模型。你给它歌词和风格提示词，它就做出带人声和伴奏的完整歌曲。它还会先把歌曲规划成一份可编辑的乐谱，所以你可以在它渲染音频之前改动旋律和和弦。卡片说它可以在本地运行，支持英文和中文。

适合谁：想根据歌词起草歌曲，并手动编辑音乐规划的词曲作者、业余音乐人和研究者。

Industry | Who uses it | How they use it | Example
音乐创作 | 词曲作者 | 把歌词和风格说明变成小样 | 由一段歌词得到的歌曲初稿
音乐制作 | 制作人 | 在乐谱里编辑旋律和和弦 | 改一条和弦线再渲染一次
研究 | 音乐 AI 研究者 | 把规划和合成当作分开的步骤来研究 | 在歌曲基准上对比输出
个人项目 | 爱好者 | 给自己的视频做背景歌曲 | 为一段家庭视频配的短歌

如果你需要为付费商业工作做音乐，可以跳过它，因为它的许可是非商业的。

用在哪里：

• 下载文件后，在 Windows、macOS 或 Linux 上用 Python
• 带 24 GB GPU 的电脑，卡片把它列为本地运行的配置
• 修改乐谱、风格和歌词的智能体环境，如卡片所述

Use case | Who | What they get back
由歌词写歌 | 词曲作者 | 带人声和伴奏的完整歌曲
乐谱编辑 | 制作人 | 改动旋律或和弦后的新版本
翻唱歌曲 | 爱好者 | 对你有权使用的歌曲的新演绎

如何设置：

• Python 和 pip
• BF16 约需 7.3 GB 磁盘空间，4-bit 约 1.8 GB（估算值）
• 不做量化地渲染 48 kHz 立体声歌曲，需要一块 24 GB 的 GPU

1. 安装 Hugging Face hub 工具。
2. 下载模型文件。
3. 按模型卡片加载模型并渲染歌曲。

pip install -U huggingface_hub
hf download m-a-p/YuE2-3B

如何使用：写好歌词和一句简短的风格提示词，然后生成。你可以用旋律加和弦来创作，也可以只用旋律，或者直接生成，还可以带上你自己的 ABC 乐谱。卡片还为开发者列出了文本引导以及分开的规划和合成步骤。

示例：你提供两段歌词，以及一条平静原声风格的提示词。模型规划出乐谱，渲染带伴奏的人声，返回一首立体声歌曲，你之后可以通过编辑乐谱来修改它。

新手与专家：如果你是新手，先用简短的歌词和一条清晰的风格提示词。听听结果，再要求修改。

YuE2 先用符号方式规划歌曲，再由规划合成音频，这就是能编辑乐谱的原因。卡片报告，在 192 条 WildSongBench 提示词上，它的八选一设置得到 6.9632 的 SongBench 平均分。这些结果是开发方自己的，并且取决于八次尝试里挑出最好的一次。

你写下歌词和风格提示词
模型把歌曲规划成乐谱
需要时你编辑旋律、和弦或歌词
模型渲染人声和音乐

注意事项：

• 硬件：卡片把 24 GB GPU 列为不做量化的本地运行配置
• 基准测试：这些数字是开发方自己的，最高分是八选一的结果

Title: WildSongBench 提示词上的 SongBench 平均分，开发方自己的对比
YuE2 best-of-8: 6.9632
Suno v5: 6.8721
Suno v6: 6.5562
Suno v6 Wild: 6.4195

• License: cc-by-nc-4.0，仅限非商业使用
• Cost to run: 没有提到 API 密钥或付费服务，只需要一块够用的 GPU
• Data it reaches: 下载会取回模型文件，你的歌词和乐谱留在你自己的运行里
• Not for: 此许可下的商业使用，或翻唱你无权使用的歌曲和声音

Hugging Face 上的数据（2026年11月13日）

• 任务：text to audio
• 参数量：3.6B
• Weights: about 7.3 GB in BF16; about 1.8 GB at 4-bit (estimate)
• Formats: Safetensors
• 最近 30 天下载：22,317
• 点赞：1,253
• 许可证：cc-by-nc-4.0
• 语言：zh, en
• Quantized versions: 25
• Fine-tunes: 12
• 标签：safetensors, yue2, music-generation, symbolic-planning, agentic-editing, text-to-audio

链接

• 模型：https://huggingface.co/m-a-p/YuE2-3B
• 文件：https://huggingface.co/m-a-p/YuE2-3B/tree/main

获取模型

用 Hugging Face 的命令行下载它的文件：

pip install -U huggingface_hub
hf download m-a-p/YuE2-3B

然后按它的模型卡使用它。这个工具包里没有会自己运行的东西。