生成歌曲(添加人声)

开发中

POST

/suno/submit/music

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

{
  "mv": "chirp-v5",                                      // 模型版本，不传默认 chirp-v5
  "prompt": "[Verse]\n新歌词",                           // 必填，演唱歌词，最多 3000 字
  "tags": "pop,female voice",                            // 演唱风格，建议填写，最多 200 字
  "title": "添加人声",                                    // 标题，可空
  "task": "overpainting",                                // 必填，固定值
  "metadata_params": {
    "overpainting_clip_id": "xxx-clip-id",               // 必填，纯音乐 clipId；也支持 mp3 公网 URL
    "overpainting_start_s": 0,                           // 必填，处理起始秒数
    "overpainting_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": "[Verse]\n新歌词",                           // 必填，演唱歌词，最多 3000 字
  "tags": "pop,female voice",                            // 演唱风格，建议填写，最多 200 字
  "title": "添加人声",                                    // 标题，可空
  "task": "overpainting",                                // 必填，固定值
  "metadata_params": {
    "overpainting_clip_id": "xxx-clip-id",               // 必填，纯音乐 clipId；也支持 mp3 公网 URL
    "overpainting_start_s": 0,                           // 必填，处理起始秒数
    "overpainting_end_s": 30                             // 必填，处理结束秒数；须 ≤ 原音频时长
  }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{}

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

生成歌曲(添加伴奏)

生成歌曲(重制)