增加伴奏 API
接口说明
增加伴奏用于在已有歌曲上重新编曲、补充乐器或生成新的伴奏结构。
接口地址：POST /api/music/add-instrumental
计费：收费，按请求模型计费，实际扣费以后台价格配置为准。
Max Mode / Variety：本接口支持可选参数 max_mode 与 variety（0-4）。开启 max_mode
时本次按 2 倍价格计费，variety 不额外计费；两者含义与写法见
新版 API 总览 的「高级参数」一节。
推荐模型：suno-v6。可用 suno-v6、suno-v6-wild 或 suno-v6-mini。
等待时间与超时（重要）：本接口是同步接口，响应返回时才代表订单已被受理并提交生成。实测多数请求 1–3 秒返回，约 10% 超过 30 秒，最长约 230 秒。请把客户端超时设置为 300 秒以上；未收到响应不等于没有生成，超时后请勿立即重试（会重复下单、重复扣费）。 连接中断可稍后用
GET /api/music/songs确认。详见新版 API 总览的「等待时间与超时设置」。
认证
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 是 | application/json |
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | 是 | - | 对客模型名：suno-v6、suno-v6-wild 或 suno-v6-mini |
| source_clip_id | string | 是 | - | 来源歌曲的真实 song_id，必须已完成且当前 API Key 可访问 |
| lyrics | string | 否 | - | 新歌词或创作方向 |
| style_tags | string | 否 | - | 风格标签 |
| song_title | string | 否 | - | 结果标题 |
| negative_tags | string | 否 | - | 负向风格标签 |
| audio_weight | number | 否 | 1 | 参考音频影响权重，范围 0.0-1.0；默认 1 表示尽量保持原歌曲参考 |
| duration | integer | 否 | - | 期望生成时长，单位秒，范围 1-480 |
| wait_completion | boolean | 否 | false | 是否等待较长时间再返回；建议保持异步使用 |
请求示例
curl -X POST https://www.suno-api.io/api/music/add-instrumental \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"source_clip_id": "source_song_id",
"lyrics": "",
"style_tags": "cinematic, strings, acoustic guitar",
"song_title": "伴奏增强版本",
"audio_weight": 1,
"wait_completion": false
}'
响应结果
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "result_song_id",
"song_title": "伴奏增强版本",
"status": "pending"
}
]
}
}
通常返回 2 条生成结果。请保存 clips[].song_id，再使用歌曲查询 API轮询到 completed。完成后可使用 audio_url 播放或下载，详见WAV 生成/获取 API和各下载接口。
注意事项
source_clip_id必须是真实、已完成且当前 API Key 可访问的歌曲 ID，不能使用pending:占位 ID。- 增加伴奏不是翻唱；需要翻唱时请使用基于源 clip 翻唱 API。
- 需要给已有歌曲增加指定乐器或音轨时，请使用加轨 API。