生成歌曲(音效)

测试中

POST

/suno/submit/music

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

{
  "mv": "chirp-v5",                                      // 模型版本
  "task": "sound",                                       // 固定：音效创作
  "metadata_params": {
    "sound": "bird sound",                               // 声音描述，必填，如 bird sound / 下雨的声音
    "type": "loop",                                      // one-shot=单次；loop=循环
    "tempo": null,                                       // 可选，BPM 1～300；不需要填 null
    "key": null                                          // 可选，音调 C / C# / Cm …；不需要填 null
  }
}

请求示例代码

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",                                      // 模型版本
  "task": "sound",                                       // 固定：音效创作
  "metadata_params": {
    "sound": "bird sound",                               // 声音描述，必填，如 bird sound / 下雨的声音
    "type": "loop",                                      // one-shot=单次；loop=循环
    "tempo": null,                                       // 可选，BPM 1～300；不需要填 null
    "key": null                                          // 可选，音调 C / C# / Cm …；不需要填 null
  }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{}

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

生成歌曲(启发创作)

局部替换歌词