跳转到主要内容
POST
音质重制
也可以用统一任务接口 POST /v1/task/submit 提交:model 填 suno/remaster,参数放进 input。两种写法效果与计费完全一样。
任务成功后,data.musics 里是产出的曲目,一次 2 条。部分成功时按实际成功的条数计费。
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。

variation_category
enum<string>

变化强度:控制重制后与原曲的差异程度。可选值:subtle 轻微;normal 适中;high 明显。

可用选项:
subtle,
normal,
high
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