直接答案:调用
POST /api/music/separate,请求体传原始歌曲song_id和"stem_mode":"twelve"。提交后按返回的任务查询状态;每条分轨都有独立song_id,可以分别下载音频或导出 MIDI。
先选两轨还是十二轨
| 模式 | 输出 | 价格 | 适合 |
|---|---|---|---|
two | 人声 + 伴奏 | 0.6 元/次 | 翻唱、K 歌、Acapella |
twelve | 鼓、贝斯、吉他、键盘、人声等 | 3 元/次 | 混音、重编曲、MIDI、采样 |
只要伴奏或干声时没必要用十二轨。需要替换鼓、只保留贝斯,或把不同声部交给不同人处理,才选十二轨。
提交十二轨分离
curl -X POST "https://www.suno-api.io/api/music/separate" -H "Authorization: Bearer $SUNO_API_KEY" -H "Content-Type: application/json" -d '{
"song_id": "YOUR_SOURCE_SONG_ID",
"stem_mode": "twelve",
"model": "suno-v6"
}'
保存响应里的任务和轨道信息。分离需要渲染时间,不要重复提交同一首歌。
查询与保存每条轨道
{
"song_id": "stem_clip_id",
"status": "completed",
"audio_url": "https://...",
"image_url": "https://..."
}
把轨道 ID 和业务声部名分开保存,例如 drums、bass、guitar、vocals。后续显示或下载时不要依赖返回顺序。
下载轨道和 MIDI
# MP3 / WAV
curl -X POST "https://www.suno-api.io/api/music/download-url" -H "Authorization: Bearer $SUNO_API_KEY" -H "Content-Type: application/json" -d '{"song_id":"stem_clip_id","kind":"song"}'
# MIDI
curl -X POST "https://www.suno-api.io/api/music/download-file" -H "Authorization: Bearer $SUNO_API_KEY" -H "Content-Type: application/json" -d '{"song_id":"stem_clip_id","kind":"midi"}' --output stem.mid
MIDI 只对已完成分轨有效,并且一次只导出单条轨道。
推荐的混音目录
project/
source.mp3
stems/
drums.mp3
bass.mp3
guitar.mp3
keys.mp3
vocals.mp3
midi/
bass.mid
guitar.mid
licence.txt
常见问题
两轨和十二轨有什么区别?
两轨只分人声与伴奏,便宜且快;十二轨给后期更多独立声部,适合专业混音。
分离后的轨道还能导出 MIDI 吗?
可以。每条完成的分轨 clip ID 都能作为 MIDI 导出请求的 song_id。
为什么某条轨道没有声音?
原曲可能没有该声部,或该段内容不足以被识别。确认原曲和返回状态后再判断。
接口文档:分轨 API;继续阅读 MIDI 导出、消除伴奏、分轨混音。


