生成歌曲(添加伴奏)

开发中

POST

/suno/submit/music

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
  "mv": "chirp-v5",                                      // 模型版本，不传默认 chirp-v5
  "prompt": "",                                          // 固定为空字符串，不传歌词
  "tags": "ambient",                                     // 伴奏风格，建议填写，最多 200 字
  "title": "添加伴奏",                                    // 标题，可空
  "task": "underpainting",                               // 必填，固定值
  "metadata_params": {
    "underpainting_clip_id": "xxx-clip-id",              // 必填，人声/清唱 clipId；也支持 mp3 公网 URL
    "underpainting_start_s": 0,                          // 必填，处理起始秒数
    "underpainting_end_s": 30                            // 必填，处理结束秒数；须 ≤ 原音频时长
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.kuai.host/suno/submit/music' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "mv": "chirp-v5",                                      // 模型版本，不传默认 chirp-v5
  "prompt": "",                                          // 固定为空字符串，不传歌词
  "tags": "ambient",                                     // 伴奏风格，建议填写，最多 200 字
  "title": "添加伴奏",                                    // 标题，可空
  "task": "underpainting",                               // 必填，固定值
  "metadata_params": {
    "underpainting_clip_id": "xxx-clip-id",              // 必填，人声/清唱 clipId；也支持 mp3 公网 URL
    "underpainting_start_s": 0,                          // 必填，处理起始秒数
    "underpainting_end_s": 30                            // 必填，处理结束秒数；须 ≤ 原音频时长
  }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{}

修改于 2026-05-31 06:48:55

生成歌曲(局部编辑)

生成歌曲(添加人声)