跳转到主要内容
POST
分段拼接
也可以用统一任务接口 POST /v1/task/submit 提交:model 填 suno/concat,参数放进 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。

audio_format
enum<string>

输出格式:成品音频的格式,不填默认 mp3。可选值:mp3 MP3(通用);m4a M4A;wav WAV(无损)。

可用选项:
mp3,
m4a,
wav
notify_hook
string<uri>

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

响应

OK

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