Skip to main content
POST
Suno 在 AIReiter 中的模型名称为 suno。歌词、续写、翻唱请分别使用 suno_lyrics、suno_extend、suno_cover。

Authorizations

string
必填
所有接口均需要使用 Bearer Token 进行认证。获取 API Key:访问 API Key 管理页面 获取您的 API Key。使用时在请求头中添加:

Body

string
必填
模型名称,固定使用:
  • suno
object
必填
模型参数对象。
string
必填
发起方任务 ID。用户自定义的任务标识,必填。仅支持字母、数字、下划线和横线,长度为 1-64 个字符。后续可使用该 ID 查询任务状态和结果。

Response

string
发起方任务 ID,可用于查询结果。
string
初始状态,通常为 "pending"。
string
创建时间,ISO 格式。

Query Task

Suno 是异步音乐生成模型。提交任务后,请使用 out_task_id 查询任务状态。完成后 output 通常包含 2 首歌曲,每项含 audio(音频 URL)、url(封面图)、title、text(歌词)。
string
必填
提交任务时传入的发起方任务 ID。
查询成功并完成后,output 示例:

Request Examples

Mode Notes

简单模式只需要 prompt。自定义模式请同时传 title 和 style;有人声时把歌词写在 prompt 中。
vocal_gender 仅在 instrumental 为 false 时生效。一次请求通常返回两首候选歌曲。