跳转到主要内容
POST
歌词创作
也可以用统一任务接口 POST /v1/task/submit 提交:model 填 suno/lyrics,参数放进 input。两种写法效果与计费完全一样。
任务成功后,data.lyrics 里是两份候选歌词,挑一份填进生成歌曲的 prompt。
string
建议标题。
string
必填
歌词正文,带 [Verse]、[Chorus] 这类段落标记。
string
建议的风格标签。

授权

Authorization
string
header
必填

在请求头 Authorization: Bearer YOUR_API_KEY 里带上 API Key。

请求体

application/json
prompt
string
必填

歌词:完整歌词,最长 5000 字。可以用 [Verse]、[Chorus] 这类标记划分段落。

lyrics_model
enum<string>
默认值:classic

歌词取向:选择歌词创作的取向。可选值:classic 经典;remi 灵感。

可用选项:
classic,
remi
notify_hook
string<uri>

推送地址:任务结束后,把和查询结果相同的内容 POST 到这个地址(公网可以访问的 http / https 地址)。不传就自己查询。

响应

OK

code
enum<string>
必填
可用选项:
success
data
object
必填
message
string