NO.1 API

任务：生成歌曲

POST

/suno/submit/music

总三种创作方式

一、灵感模式

只需提交以下参数：suno会自动生成歌名、歌词、风格、歌曲。
gpt_description_prompt make_instrumental mv

二、定制模式

需要提交以下参数
prompt title tags mv

三、续写模式

需要在定制模式基础上携带以下参数
task_id continue_at continue_clip_id

请求参数

Body 参数application/json

make_instrumental

boolean

是否纯音乐（灵感模式专用）

可选

gpt_description_prompt

string

歌曲提示词（灵感模式专用）

可选

enum<string>

模型版本

可选

枚举值:

chirp-v3-0chirp-v3-5

示例值:

chirp-v3-0

prompt

string

歌词（定制模式专用）

可选

空字符串将自动转为纯音乐

title

string

歌名（定制模式专用）

可选

tags

string

风格标签（定制模式专用）

可选

task_id

string

任务ID

可选

用于对之前的任务进行再操作

continue_at

number

歌曲续写时长

可选

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

continue_clip_id

string

续写歌曲ID

可选

指定需要续写的歌曲ID

notify_hook

string

回调地址

可选

示例

1. 灵感模式

{
    "gpt_description_prompt": "欢快的磁性女声歌曲，中文，主题：难忘周末"
}

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-v3-0",
    "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-v3-0",
    "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": "欢快的磁性女声歌曲，中文，主题：难忘周末"
}

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-v3-0",
    "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-v3-0",
    "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

必需

示例

{
  "code": "success",
  "message": "",
  "data": "2a145658-3342-4228-b779-b8323a2b77df"
}

接口介绍

聊天方式：生成歌曲