生成音乐

请求参数

Query 参数

string

可选

Header 参数

Authorization

string

必需

在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 Token

示例值:

Bearer Token

string

可选

Body 参数application/json

prompt

string

必需

歌词 (自定义模式专用)

enum<string>

可选

版本号,填写chirp-v4或chirp-v3-5,当前默认为chirp-v3-5

枚举值:

chirp-v3-5chirp-v4

title

string

可选

标题(自定义模式专用)

tags

string

可选

风格标签(自定义模式专用)，如：tarantella, house, witch house, electro, pop, rock, punk, rap, metal, swing, funk, electro swing, pop rock, classic dubstep, chinese folk, french dub

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://abc.com

示例

1.灵感模式

{
    "gpt_description_prompt": "dog"
}

2.自定义模式
{
    "prompt": "[Verse]\\n蛇年到来人欢笑\\n烟花绽放天空耀\\n红灯笼挂满小巷\\n好运连连心中藏\\n\\n[Verse 2]\\n舞龙舞狮庆祝忙\\n新衣新鞋穿上场\\n一家团圆煮年糕\\n祝福声声响天高\\n\\n[Chorus]\\n蛇年好运运势高\\n福星高照不动摇\\n行大运来财运到\\n喜气洋洋心欢跳\\n\\n[Verse 3]\\n年夜饭桌菜肴香\\n亲朋好友齐来尝\\n鞭炮声声驱邪恶\\n新的一年更辉煌\\n\\n[Bridge]\\n希望连连心欢畅\\n梦想成真迎朝阳\\n蛇年吉祥如意长\\n富贵平安永流淌\\n\\n[Chorus]\\n蛇年好运运势高\\n福星高照不动摇\\n行大运来财运到\\n喜气洋洋心欢跳",
    "tags": "emotional punk",
    "mv": "chirp-v4",
    "title":"2025元旦快乐",
}

3.续写模式(暂未启用上传接口)
{
    "prompt": "[Verse]\\n蛇年到来人欢笑\\n烟花绽放天空耀\\n红灯笼挂满小巷\\n好运连连心中藏\\n\\n[Verse 2]\\n舞龙舞狮庆祝忙\\n新衣新鞋穿上场\\n一家团圆煮年糕\\n祝福声声响天高\\n\\n[Chorus]\\n蛇年好运运势高\\n福星高照不动摇\\n行大运来财运到\\n喜气洋洋心欢跳\\n\\n[Verse 3]\\n年夜饭桌菜肴香\\n亲朋好友齐来尝\\n鞭炮声声驱邪恶\\n新的一年更辉煌\\n\\n[Bridge]\\n希望连连心欢畅\\n梦想成真迎朝阳\\n蛇年吉祥如意长\\n富贵平安永流淌\\n\\n[Chorus]\\n蛇年好运运势高\\n福星高照不动摇\\n行大运来财运到\\n喜气洋洋心欢跳", // 可以空 ""
    "tags": "bass-driven atmospheric heavy metal",
    "negative_tags": "dance",
    "mv": "chirp-v3-5", // 上传后续写 chirp-v3-5-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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://one.api4gpt.com/suno/submit/music' \
--header 'Authorization: Bearer Token' \
--header 'Content-Type: application/json' \
--data-raw '1.灵感模式

{
    "gpt_description_prompt": "dog"
}

2.自定义模式
{
    "prompt": "[Verse]\\n蛇年到来人欢笑\\n烟花绽放天空耀\\n红灯笼挂满小巷\\n好运连连心中藏\\n\\n[Verse 2]\\n舞龙舞狮庆祝忙\\n新衣新鞋穿上场\\n一家团圆煮年糕\\n祝福声声响天高\\n\\n[Chorus]\\n蛇年好运运势高\\n福星高照不动摇\\n行大运来财运到\\n喜气洋洋心欢跳\\n\\n[Verse 3]\\n年夜饭桌菜肴香\\n亲朋好友齐来尝\\n鞭炮声声驱邪恶\\n新的一年更辉煌\\n\\n[Bridge]\\n希望连连心欢畅\\n梦想成真迎朝阳\\n蛇年吉祥如意长\\n富贵平安永流淌\\n\\n[Chorus]\\n蛇年好运运势高\\n福星高照不动摇\\n行大运来财运到\\n喜气洋洋心欢跳",
    "tags": "emotional punk",
    "mv": "chirp-v4",
    "title":"2025元旦快乐",
}

3.续写模式(暂未启用上传接口)
{
    "prompt": "[Verse]\\n蛇年到来人欢笑\\n烟花绽放天空耀\\n红灯笼挂满小巷\\n好运连连心中藏\\n\\n[Verse 2]\\n舞龙舞狮庆祝忙\\n新衣新鞋穿上场\\n一家团圆煮年糕\\n祝福声声响天高\\n\\n[Chorus]\\n蛇年好运运势高\\n福星高照不动摇\\n行大运来财运到\\n喜气洋洋心欢跳\\n\\n[Verse 3]\\n年夜饭桌菜肴香\\n亲朋好友齐来尝\\n鞭炮声声驱邪恶\\n新的一年更辉煌\\n\\n[Bridge]\\n希望连连心欢畅\\n梦想成真迎朝阳\\n蛇年吉祥如意长\\n富贵平安永流淌\\n\\n[Chorus]\\n蛇年好运运势高\\n福星高照不动摇\\n行大运来财运到\\n喜气洋洋心欢跳", // 可以空 ""
    "tags": "bass-driven atmospheric heavy metal",
    "negative_tags": "dance",
    "mv": "chirp-v3-5", // 上传后续写 chirp-v3-5-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" 
}'

请求参数

示例代码

返回响应