API Docs

生成歌曲(续写模式)

POST

{{BASE_URL}}/suno/submit/music

最后修改时间：2025-04-29 07:33:28

任务创建成功后，请通过 task id 轮询查询接口，获取任务进度和结果
分为3种模式

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

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

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

上传音频后续写，参数修改
"mv": "chirp-v3-5-upload",
"task": "extend"

请求参数

Query 参数

string

可选

Header 参数

Authorization

string

可选

示例值:

Bearer {{YOUR_API_KEY}}

Content-Type

string

可选

示例值:

application/json

string

可选

示例值:

application/json

string

可选

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

示例

{
  "prompt": "[Verse]\nMove your paws\nLeft and right\nJump around\nFeel the light\nWhiskers twitch\nTails in the air\nDancing cats\nEverywhere\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow\n\n[Verse 2]\nTiptoe steps\nSoft and sweet\nTiny paws\nUnbeatable beat\nMeow to the rhythm\nClaws precise\nEvery move\nFeline paradise\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow\n\n[Bridge]\nOoh-ooh\nBounce and sway (ooh-ooh!)\nMoonlit grooves\nNight turns to day\nLean and stretch\nStrike your pose\nEvery kitty steals the show\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow",
  "mv": "chirp-v4",
  "title": "Cat Dance",
  "tags": "romantic raga",
  "task_id": "736a6f88-bd29-4b1e-b110-37132a5325ac",
  "continue_at": 123,
  "continue_clip_id": "4c4c80c4-6318-48c7-a314-71dd03ba3a11",
  "task": "extend"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '{{BASE_URL}}/suno/submit/music' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "[Verse]\nMove your paws\nLeft and right\nJump around\nFeel the light\nWhiskers twitch\nTails in the air\nDancing cats\nEverywhere\n\n[Chorus]\nCat dance\nOh\nLet'\''s go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet'\''s steal the glow\n\n[Verse 2]\nTiptoe steps\nSoft and sweet\nTiny paws\nUnbeatable beat\nMeow to the rhythm\nClaws precise\nEvery move\nFeline paradise\n\n[Chorus]\nCat dance\nOh\nLet'\''s go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet'\''s steal the glow\n\n[Bridge]\nOoh-ooh\nBounce and sway (ooh-ooh!)\nMoonlit grooves\nNight turns to day\nLean and stretch\nStrike your pose\nEvery kitty steals the show\n\n[Chorus]\nCat dance\nOh\nLet'\''s go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet'\''s steal the glow",
    "mv": "chirp-v4",
    "title": "Cat Dance",
    "tags": "romantic raga",
    "task_id": "736a6f88-bd29-4b1e-b110-37132a5325ac",
    "continue_at": 123,
    "continue_clip_id": "4c4c80c4-6318-48c7-a314-71dd03ba3a11",
    "task": "extend"
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

message

string

错误信息

必需

data

string

task_id

必需

示例

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

修改于 2025-04-29 07:33:28

生成歌曲(自定义模式)

生成歌词