生成歌曲(哼唱成曲)

测试中

POST

/suno/submit/music

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

{
  "mv": "chirp-v5",                                      // 建议 v5 及以上（chirp-v5 / chirp-v5-5）
  "make_instrumental": false,                            // false=有人声成曲，true=纯音乐成曲
  "prompt": "[Verse 1]\n太阳爬上小窗台\n...",            // 必填，完整歌词，最多 3000 字
  "tags": "pop,female voice",                            // 风格，建议填写，最多 200 字
  "title": "哼唱成曲测试",                                // 标题，可空
  "task": "chop_sample_condition",                       // 必填，固定值
  "metadata_params": {
    "chop_sample_clip_id": "4b2300c2-f200-4011-8f80-e3401da28c4f",  // 必填，参考 clipId；也支持 mp3 公网 URL
    "chop_sample_start_s": 0,                            // 必填，参考片段起始秒
    "chop_sample_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",                                      // 建议 v5 及以上（chirp-v5 / chirp-v5-5）
  "make_instrumental": false,                            // false=有人声成曲，true=纯音乐成曲
  "prompt": "[Verse 1]\n太阳爬上小窗台\n...",            // 必填，完整歌词，最多 3000 字
  "tags": "pop,female voice",                            // 风格，建议填写，最多 200 字
  "title": "哼唱成曲测试",                                // 标题，可空
  "task": "chop_sample_condition",                       // 必填，固定值
  "metadata_params": {
    "chop_sample_clip_id": "4b2300c2-f200-4011-8f80-e3401da28c4f",  // 必填，参考 clipId；也支持 mp3 公网 URL
    "chop_sample_start_s": 0,                            // 必填，参考片段起始秒
    "chop_sample_end_s": 30                              // 必填，参考片段结束秒；须 ≤ 原音频时长
  }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{}

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

上传参考音频

生成歌曲(混音)