生成歌曲(自定义模式)

POST

https://yunwu.ai/suno/submit/music

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

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

必需

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

示例

{
    "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",
    "continue_at": 120,
    "continue_clip_id": "",
    "task": ""
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://yunwu.ai/suno/submit/music' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--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",
    "continue_at": 120,
    "continue_clip_id": "",
    "task": ""
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

data

string

必需

message

string

必需

示例

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

修改于 2025-06-05 18:12:43

生成歌曲(灵感模式)

生成歌曲(续写模式)