AI 音乐
用 Mureka 生成、混音、续写和分析 AI 音乐 — 歌曲、纯音乐、配乐、分轨和歌词。
用提示词或歌词生成原创 AI 音乐、混音已有歌曲、为图片或视频配乐、提取单轨，或分析音频 — 全部由 Mureka 提供方驱动，通过 listenhub music CLI 执行。
触发方式
输入 /music 命令，或使用以下任意短语触发：
| 短语 | 语言 |
|---|---|
music / generate music / compose | 英文 |
create a song / cover / remix | 英文 |
instrumental / soundtrack / stem | 英文 |
recognize lyrics / extend | 英文 |
音乐 / 生成音乐 / 作曲 / 做一首歌 | 中文 |
翻唱 / 混音 / 续写 / 纯音乐 | 中文 |
配乐 / 分轨 / 识别歌词 | 中文 |
使用前请先安装 ListenHub Skills — 参见快速开始。
本技能不使用主播 — 音乐生成没有音色选择环节。
快速示例
做一首关于夏天海边傍晚的歌AI 会先与你确认能力和参数，提交任务，并在曲子生成完成时通知你。你会收到收听链接、时长和消耗的积分；当输出方式设为 download 或 both 时，还会下载到本地。
能力
技能分为两组：生成类命令异步执行，返回一个任务供轮询；分析类命令同步执行，在同一次调用中直接返回结果。
generate — 用文字和/或歌词生成全新歌曲。prompt 和 lyrics 至少提供其一。可选 style、title、model、纯音乐开关，以及一个克隆音色 vocal-id。异步。
remix — 用已有歌曲加新歌词重新创作。输入源恰好提供一个：音频文件、音频 URL，或 Mureka 的 provider-song-id。lyrics 和 prompt 都为必填。可选 style、title、model。异步。
instrumental — 生成无人声的纯器乐。prompt 或参考音频 reference-audio 恰好提供其一。可选 title、model。异步。
soundtrack — 为图片或视频配乐。image 或 video 恰好提供其一。可选 prompt、title、model。异步。
track — 从歌曲中提取或生成单条乐器/人声轨。提供一个输入源（音频文件或 provider-song-id）加上 generate-type。当类型为 Vocals 时，lyrics 必填。可选 prompt、vocal-gender，以及以秒为单位的 generate-start/generate-end 时间范围。异步。
extend — 把已有歌曲续写得更长。提供一个输入源（音频文件或 provider-song-id）。可选描述续写方向的 prompt 和 model。异步。
recognize — 从音频文件中提取带逐行时间戳的歌词。同步 — 结果立即返回。
describe — 分析音频文件，输出描述、标签、流派和乐器。同步 — 结果立即返回。
stem — 把一首歌拆分为分离的音轨，返回 ZIP 下载链接。可选分离模型（audio-separation-1 或 audio-separation-2）。同步 — 结果立即返回。
还有一个 cover 能力，但已弃用 — 除非你明确需要旧版翻唱流程，否则请改用 remix。
随时可用的两个任务管理命令：list 列出最近任务，get <taskId> 返回单个任务的状态或结果。
模型
生成类命令接受 model 参数。默认为 auto，由服务自动选择。
| 模型 | 说明 |
|---|---|
auto | 默认 — 由服务选择模型 |
mureka-7.6 | Mureka 7.6 |
mureka-8 | Mureka 8 |
mureka-9 | Mureka 9 |
mureka-o2 | Mureka o2 |
分析类不同。stem 命令使用分离模型 — audio-separation-1 或 audio-separation-2。recognize 和 describe 不接受模型参数。
参数
参数按能力区分。每条命令只提供它需要的部分；AI 会询问必填项并提供可选项。
| 参数 | 适用能力 | 说明 |
|---|---|---|
prompt | generate、remix、instrumental、soundtrack、track、extend | 描述音乐或方向的自由文本 |
lyrics | generate、remix、track（仅 Vocals） | 歌词 |
style | generate、remix | 流派或氛围，如 city pop |
title | generate、remix、instrumental、soundtrack | 曲目标题；不填则自动生成 |
model | 生成类命令 | 上述模型之一；默认 auto |
instrumental | generate | 关闭人声开关 |
vocal-id | generate | 克隆音色 id |
audio / audio-url / provider-song-id | remix、track、extend | 输入歌曲；恰好提供一个 |
reference-audio | instrumental | 参考音频文件（prompt 的替代项） |
image / video | soundtrack | 源媒体；恰好提供一个 |
generate-type | track | Vocals、Instrumental、Drums、Bass、Guitar、Keyboard、Percussion、Strings、Synth、FX、Brass、Woodwinds 之一 |
vocal-gender | track | male 或 female |
generate-start / generate-end | track | 时间范围，单位为秒 |
文件限制
所有输入文件上限为 10 MB。按类型支持的格式：
| 类型 | 格式 |
|---|---|
| 音频 | mp3、m4a（track 命令还支持 wav） |
| 图片 | jpg、jpeg、png、webp |
| 视频 | mp4、mov、avi、mkv、webm |
在命令支持的场景下，你也可以传入 URL 替代本地文件；CLI 会在提交时校验。
音乐生成较慢 — 每首曲子大约需要 5 到 10 分钟。AI 会在后台提交任务并在完成时通知你。如果你只有任务 id，可用 listenhub music get <taskId> --json 查看进度，或用 listenhub music list --json 浏览。
输出
输出行为遵循配置中设置的 outputMode：
inline或both— 音频 URL 以可点击的收听链接呈现，并附带标题、时长和消耗积分。download或both— 文件还会以友好的、基于主题的名称（如summer-breeze.mp3）保存到当前工作目录，重名会自动去重。
对于 stem，结果是一个或多个 ZIP 下载链接；在 download 或 both 模式下会被下载到当前目录。对于 recognize 和 describe，结果直接显示在对话中。
每个完成的任务都会报告 creditCost。要估算或查询积分，参见 音乐 API 文档 中的积分说明，并通过 GET /v1/user/subscription 查看余额。
CLI 命令
本技能驱动 listenhub music 命令组。常见用法：
# 生成歌曲（异步 — 轮询直到完成）
listenhub music generate --prompt "upbeat summer pop about the sea" --json
# 用新歌词混音已有文件
listenhub music remix --audio demo.mp3 --lyrics "..." --prompt "rework as city pop" --json
# 纯音乐
listenhub music instrumental --prompt "electronic track for a game intro" --json
# 为视频配乐
listenhub music soundtrack --video clip.mp4 --prompt "tense, suspenseful score" --json
# 分析音频（同步）
listenhub music recognize --audio song.mp3 --json
listenhub music describe --audio song.mp3 --json
listenhub music stem --audio track.mp3 --model audio-separation-2 --json
# 任务管理
listenhub music list --json
listenhub music get <taskId> --json全局标志同样适用：--json / -j 输出机器可读结果，--no-wait 跳过轮询，--timeout <s> 限制轮询时间。
API 参考
接口路径、请求参数、响应字段和积分处理详见 音乐 API 文档。