生成歌曲（API格式）

POST

/suno/submit/music

分为3种模式

灵感模式：
只需要提交以下参数
gpt_description_prompt
make_instrumental
mv
Suno 会自动生成歌词、标题、风格标签

自定义模式：
需要提交参数
prompt
title
tags
make_instrumental
mv

3.续写
需要在自定义模式基础上携带
task_id
continue_at
continue_clip_id

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Authorization

string

可选

示例值:

Bearer {{YOUR_API_KEY}}

Content-Type

string

可选

示例值:

application/json

string

可选

示例值:

application/json

Body 参数application/json

prompt

string

可选

歌词 (自定义模式专用)

string

可选

mv模型，chirp-v3-0、chirp-v3-5。不写默认 chirp-v3-0

title

string

可选

标题(自定义模式专用)

tags

string

可选

风格标签(自定义模式专用)

make_instrumental

boolean

必需

是否生成纯音乐，true 为生成纯音乐

task_id

string

可选

任务id，用于对之前的任务再操作

continue_at

number

可选

float，歌曲延长时间，单位秒

continue_clip_id

string

可选

歌曲id，需要续写哪首歌

gpt_description_prompt

string

可选

灵感模式提示词(灵感模式专用)

notify_hook

string

可选

回调地址： https://xxxxxxx

示例

以下任选其一

1.灵感模式

{
    "gpt_description_prompt": "cat"
}

2.自定义模式（推荐）
{
    "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'm alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it's music to my ears\nThe hustle and the bustle\nWiping away my fears",
    "tags": "emotional punk",
    "mv": "chirp-auk",
    "title": "City Lights"
}

3.续写（推荐）
{
    "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'm alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it's music to my ears\nThe hustle and the bustle\nWiping away my fears",
    "tags": "bass-driven atmospheric heavy metal",
    "mv": "chirp-auk",
    "title": "City Lights",
    "task_id": "736a6f88-bd29-4b1e-b110-37132a5325ac"
    "continue_clip_id": "ce2cfbce-9ea0-45b0-9386-020c0ff54a49",
    "continue_at": 80
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/suno/submit/music' \
--header 'Content-Type: application/json' \
--data-raw '以下任选其一

1.灵感模式

{
    "gpt_description_prompt": "cat"
}

2.自定义模式（推荐）
{
    "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'\''m alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it'\''s music to my ears\nThe hustle and the bustle\nWiping away my fears",
    "tags": "emotional punk",
    "mv": "chirp-auk",
    "title": "City Lights"
}

3.续写（推荐）
{
    "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'\''m alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it'\''s music to my ears\nThe hustle and the bustle\nWiping away my fears",
    "tags": "bass-driven atmospheric heavy metal",
    "mv": "chirp-auk",
    "title": "City Lights",
    "task_id": "736a6f88-bd29-4b1e-b110-37132a5325ac"
    "continue_clip_id": "ce2cfbce-9ea0-45b0-9386-020c0ff54a49",
    "continue_at": 80
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

message

string

错误信息

必需

data

string

task_id

必需

示例

{
    "code": "success",
    "message": "",
    "data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}

修改于 2025-06-09 18:11:33

response_format

生成歌词（API格式）