Skip to main content
POST

请求头

Authorization
string
必填

Bearer API Key,例如 Bearer sk-...。

示例:

"Bearer sk-..."

请求体

application/json

Suno 音乐提交体(自定义歌词 / 描述模式)。

prompt
string

歌词内容(自定义模式)。

示例:

"[主歌]\n霓虹倒映在潮湿路面\n[副歌]\n我们穿过整座不夜城"

tags
string

歌曲风格标签,如曲风 / 情绪 / 乐器。

示例:

"电影感独立流行, 氛围感, 霓虹"

title
string

歌曲标题。

示例:

"霓虹雨"

mv
string

模型版本(如 chirp-v4、chirp-auk,以上游为准)。

示例:

"chirp-v4"

gpt_description_prompt
string

不写完整歌词时的自然语言描述(描述模式)。

示例:

"一首关于在未来城市霓虹雨中行走的轻快独立流行曲"

make_instrumental
boolean

是否纯伴奏(无人声)。

示例:

false

continue_at
number

从该时间点(秒)继续生成。

continue_clip_id
string

续写的 clip id。

task_id
string

续写关联的任务 id。

响应

200 - application/json

任务已受理

code
string
示例:

"success"

message
string
data
string

公开 task id(task_xxxx)。

示例:

"task_xxxxxxxx"