跳转到主要内容
POST
变速处理
也可以用统一任务接口 POST /v1/task/submit 提交:model 填 suno/adjust-speed,参数放进 input。两种写法效果与计费完全一样。
任务成功后,data.musics 里是产出的音轨。
string
必填
曲目 ID。续写、翻唱、分轨、导出等后续操作都填它。
string
标题。
string
风格标签。
string
歌词,纯伴奏没有这个字段。
string
音频地址,可直接下载。
string
封面图地址。
string
大尺寸封面图地址。
string
视频地址,没有视频时不返回。
number
时长,单位秒。

授权

Authorization
string
header
必填

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

请求体

application/json
music_id
string
必填

源曲目:要处理的曲目,填之前生成结果里的 music_id。

title
string
必填

标题:曲目标题,最长 80 字。

keep_pitch
boolean
默认值:false

保持音高:变速时保持原来的音调不变;关闭则音调会随速度升降。

speed_multiplier
number
默认值:1

速度倍率:播放速度倍数,0.25 到 4 之间。1 为原速。

notify_hook
string<uri>

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

响应

OK

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