生成歌曲(灵感模式)

POST

/suno/submit/music

最后修改时间：2025-07-09 07:01:48

责任人：未设置

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

string

必需

示例值:

application/json

Authorization

string

可选

示例值:

Bearer {{YOUR_API_KEY}}

Body 参数application/json

prompt

string

必需

歌词内容，仅用于自定义模式

string

必需

模型选择，可选 chirp-v3-0、chirp-v3-5，默认为 chirp-v3-0

title

string

必需

歌曲标题，仅用于自定义模式

tags

string

必需

风格标签，仅用于自定义模式，多个标签用半角逗号分隔

make_instrumental

boolean

必需

是否生成纯音乐版本，true 表示生成纯音乐

task_id

string

必需

任务ID，用于对已有任务进行操作（如续写）

continue_at

number

必需

续写起始时间点，浮点数，单位为秒

continue_clip_id

string

需要续写的歌曲ID

必需

gpt_description_prompt

string

必需

创作描述提示词，仅用于灵感模式

notify_hook

string

必需

任务完成后的回调通知地址

示例

{
    "gpt_description_prompt": "cat dance",
    "make_instrumental": false,
    "mv": "chirp-v4",
    "prompt": "Cat Dance"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/suno/submit/music' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "gpt_description_prompt": "cat dance",
    "make_instrumental": false,
    "mv": "chirp-v4",
    "prompt": "Cat Dance"
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

data

string

必需

message

string

必需

示例

{
    "code": "success",
    "data": "950bf3af-78a6-420e-8c01-3bde0bbb3ef9",
    "message": ""
}

修改于 2025-07-09 07:01:48

参数

生成歌曲(自定义模式)