Skip to main content
使用 AI 生成音乐和歌词。这是一个异步 API - 您将收到一个任务 ID 用于轮询完成状态。

请求体

string
默认值:"suno_music"
使用的模型:suno_music 用于音乐生成,suno_lyrics 仅用于歌词。
string
生成音乐的描述。音乐、歌词、upload-cover 和 upload-extend 请求必填;add-instrumental 可省略。
string
生成歌曲的标题。
string
风格标签(例如 “pop, upbeat, electronic”)。
string
需要避开的风格。audio_operationadd-instrumental 时必填。
string
生成类型:MUSIC(默认)或 LYRICS
string
官方 Suno 模型版本。音乐生成必填(省略 action 或使用 MUSIC 时);仅歌词请求请省略。支持值:chirp-v3-5, chirp-v4, chirp-v4-5, chirp-v4.5, chirp-v4-5plus, chirp-v4.5plus, chirp-v4-5all, chirp-v4.5all, chirp-v5, chirp-v5-5, chirp-v5.5
boolean
设为 true 时生成无歌声的纯音乐。
string
可公开访问的参考/上传音频 URL。提供该字段但不传 audio_operation 时,默认使用 upload-cover 流程。
string
上传音频模式:upload-coverupload-extendadd-instrumentalupload-extend 需要 continue_atadd-instrumental 需要 audio_urltitletagsnegative_tags
string
要续写的上一个片段的 ID。
number
续写的起始时间戳(以秒为单位)。audio_operationupload-extend 时必填。

响应

string
用于轮询状态的任务 ID。
string
任务状态:pendingprocessingcompletedfailed
integer
任务创建的 Unix 时间戳。