YuE2-hum-to-song

YuE2-hum-to-song

把 10 到 30 秒的哼唱旋律，加上风格描述和歌词，变成一首跟随你旋律的完整歌曲。这是 YuE2-3B 音乐模型的扩展，适合词曲创作者和音频研究人员。

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

简介

它是什么：YuE2-hum-to-song 接收一段 10 到 30 秒的哼唱、一行说明风格的文字和一些歌词，返回一首以你的旋律为基础的完整歌曲。它基于 m-a-p/YuE2-3B，并加入了两个机制。一个是接续由你的哼唱写成的乐谱，另一个是经过训练的适配器，把你哼唱的音高和节奏带进解码器。

适合谁：如果你习惯用哼唱来起头写歌，想要一份完整的歌曲草稿，或者你是想研究哼唱如何引导两阶段音乐模型的研究人员，它适合你。

行业 | 谁在用 | 怎么用 | 例子
音乐 | 词曲创作者 | 把哼出来的想法变成完整的歌曲草稿 | 约 20 秒的哼唱变成一首 2 到 3 分钟、带结尾的歌
创意工具 | ComfyUI 用户 | 在 ComfyUI 里运行哼唱转歌曲的流程 | 把哼唱、风格描述和歌词送入工作流
研究 | 音频机器学习研究人员 | 研究乐谱接续和韵律适配器 | 用同一段哼唱比较三种旋律模式

如果你需要用于商业工作的模型，可以跳过它，因为它的许可证是非商业的。

用在哪里：模型卡说，你可以用仓库里的脚本，或者在 ComfyUI 里运行它。它的文件可以下载到装有 Python 的 Windows、macOS 或 Linux。

• 随模型文件提供的脚本
• ComfyUI
• 装有 huggingface_hub 包的 Windows、macOS 或 Linux

使用场景 | 谁用 | 得到什么
哼唱生成完整歌曲 | 词曲创作者 | 一首保留你旋律、并加入新段落和结尾的歌
只用哼唱 | 音乐人 | 一首恰好就是你旋律的歌，不多加别的
忽略哼唱 | 研究人员 | 规划器自己写的乐谱，适配器仍可调整乐句

如何设置：你需要 Python、本模型所基于的 YuE2-3B 基础模型，以及运行模型卡脚本或 ComfyUI 的方式。这里展示的模型卡部分没有列出硬件要求。

• Windows、macOS 或 Linux 上的 Python
• Hugging Face hub 包
• 基础模型 m-a-p/YuE2-3B

1. 安装 Hugging Face hub 包。
2. 下载这个模型的文件。
3. 按模型卡的说明运行脚本，或在 ComfyUI 里加载这些文件。

pip install -U huggingface_hub
hf download Mothersuperior/YuE2-hum-to-song

如何使用：录一段 10 到 30 秒的哼唱，写一行说明风格的文字加上歌词，在三种旋律模式里选一种，然后运行模型卡的脚本或 ComfyUI 设置。歌曲的其余部分会围绕你的旋律写出来。

Tool | What it does
Continue from hum | 在你的旋律之后写出新段落、过渡和结尾，调性和拍号保持一致
Hum only | 在你的哼唱之后直接结束乐谱，得到的歌曲只由你的旋律构成
Ignore hum | 让规划器自己写乐谱，适配器仍可调整乐句

示例：你哼了约 20 秒的旋律，加上风格描述和几句歌词，并选择 continue from hum。你会得到一首 2 到 3 分钟的歌。在作者的测试中，哼唱的乐句会再出现两到四次，通常是作为副歌的主旋律。

新手与专家：如果你刚接触，可以把它当作用你的声音起头写歌的方法。第一件小事是用上面两条命令下载文件，然后读模型卡，看怎么运行脚本。

如果你熟悉这个领域，YuE2 分两个阶段工作。AR 规划器先写出 ABC 乐谱，再写语义令牌，NAR 解码器通过流匹配把它们变成 VAE 潜变量，最后 VAE 解码出 48 kHz 音频。旋律由规划器决定，所以哼唱会进入两次。没有结束标记的乐谱前缀让规划器继续往下写。然后韵律适配器给解码器输入一个跟随你音高和节奏的正弦波，所以解码器从不会看到你的音色或歌词。

哼唱被转写成 ABC 乐谱
规划器接续乐谱
规划器写出语义令牌
带韵律适配器的解码器加入你的音高
VAE 解码出 48 kHz 音频

注意事项：适配器是一个 rank-64 的 LoRA 加上几个投影层，合并版本把它与作者的真实音频解码器 LoRA 合成一个 rank-96 的 LoRA。第一个机制不需要训练。

• License: cc-by-nc-4.0，只允许非商业使用
• Cost to run: 没有提到任何 API 密钥、账号或付费服务，这里展示的部分也没有给出硬件要求
• Data it reaches: 下载来自 Hugging Face，模型处理你给它的哼唱音频、风格描述和歌词
• Not for: 商业用途，因为许可证是非商业的

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

• 最近 30 天下载：0
• 点赞：47
• 许可证：cc-by-nc-4.0
• 基于：m-a-p/YuE2-3B
• 标签：audio, music, yue2, lora, hum-to-song

链接

• 模型：https://huggingface.co/Mothersuperior/YuE2-hum-to-song
• 文件：https://huggingface.co/Mothersuperior/YuE2-hum-to-song/tree/main

获取模型

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

pip install -U huggingface_hub
hf download Mothersuperior/YuE2-hum-to-song

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