API reference
🇺🇸 English
  • 🇨🇳 Chinese
  • 🇺🇸 English
  1. Suno
API reference
🇺🇸 English
  • 🇨🇳 Chinese
  • 🇺🇸 English
  • Chat Models
    • Chat
      • Create chat completion
      • vision
    • OpenAI-Realtime
    • Completions
      • Instruct
    • Audio
      • Transcriptions
      • Translations
      • Speech
    • Image generation
      • DALL·E 3
    • Embeddings
      • Create
    • Models
      • model list
    • Help
      • 常见问题及解决办法
  • Anthropic
    • Anthropic Claude
  • Suno
    • Generate music
      POST
    • Generate lyrics
      POST
    • Upload music
      POST
    • Music concat
      POST
    • Fetch task
      GET
    • Fetch batch tasks
      POST
  • Udio
    • Generate music
    • Fetch task
  • Midjourney API
    • Quick
    • Task Submit
      • Imagine
      • Action
      • Modal
      • Blend
      • Describe
      • Shorten
      • Upload discord
    • Get Task
      • Fetch task by ids
      • Fetch task by id
      • Get seed
  • Flux
    • Official
      • Generate
      • Finetune
      • Fetch task
    • OpenAI Dalle3
  • Recraft
    • Official
      • Generate Image
      • Vectorize Image
      • Remove Background
      • Clarity Upscale
      • Generative Upscale
      • Create style
    • OpenAI Dalle3
  • Ideogram
    • Generate
    • Remix
    • Edit
    • Upscale
    • Describe
  • Luma
    • Official
      • Generate
      • Fetch task
    • Own format
      • Submit
        • Generate
        • Get video of no mark
        • 扩展视频
      • Get task
        • Get task
        • Get batch task
  • Runway
    • Official
      • image to video
      • get task
    • reverse
      • text to video
      • image to video
      • video2video
      • Act-one
      • Get task
  • Kling-API
    • Callback
    • Generate image
    • Text 2 Video
    • Image 2 Video
    • Video extend
    • Get task
    • lip-sync
    • kolors-virtual-try-on
  • Replicate
    • Generate
    • Get
  • MiniMax
    • Generate video
    • Get task
    • Get file
  1. Suno

Generate music

POST
/suno/submit/music
最后修改时间:2025-05-06 01:23:05

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Header 参数
Authorization
string 
可选
示例值:
Bearer
Body 参数application/json
prompt
string 
必需
歌词 (自定义模式专用)
mv
string 
可选
版本号,填写chirp-v4或chirp-v3-5,当前默认为chirp-v3-5
title
string 
可选
标题(自定义模式专用)
tags
string 
可选
风格标签(自定义模式专用)
negative_tags
string 
排除的风格标签
可选
make_instrumental
boolean 
必需
是否生成纯音乐,true 为生成纯音乐
task_id
string 
可选
任务id,用于对之前的任务再操作
continue_at
number 
可选
float,歌曲延长时间,单位秒
continue_clip_id
string 
可选
歌曲id,需要续写哪首歌
task
string 
上传后续写必填
可选
示例值:
extend
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-v4",
    "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",
    "negative_tags": "dance",
    "mv": "chirp-v4", // 上传后续写 chirp-v4-upload
    "title": "City Lights",
    "task_id": "736a6f88-bd29-4b1e-b110-37132a5325ac",
    "continue_clip_id": "736a6f88-bd29-4b1e-b110-37132a5325ac_1", // 填写结尾带序号的id,不是clip_id
    "continue_at": 80,
    "task": "extend" 
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST '/suno/submit/music' \
--header 'Authorization: Bearer' \
--header 'Authorization;' \
--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-v4",
    "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",
    "negative_tags": "dance",
    "mv": "chirp-v4", // 上传后续写 chirp-v4-upload
    "title": "City Lights",
    "task_id": "736a6f88-bd29-4b1e-b110-37132a5325ac",
    "continue_clip_id": "736a6f88-bd29-4b1e-b110-37132a5325ac_1", // 填写结尾带序号的id,不是clip_id
    "continue_at": 80,
    "task": "extend" 
}'

返回响应

🟢200成功
application/json
Body
code
string 
必需
message
string 
必需
data
string 
task_id
必需
示例
{
    "code": "success",
    "message": "",
    "data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}
上一页
Anthropic Claude
下一页
Generate lyrics
Built with