上传参考音频
提交公开可访问的参考音频 URL,获取供翻唱、续写或添加人声使用的音轨 ID。
此接口接收 JSON 中的 audio_url,不是 Multipart 文件上传。通过 is_async 选择同步或异步处理。
POST
/suno/mj/submit/uploadAuthorization
bearerAuth AuthorizationBearer <token>
使用 Authorization: Bearer your-api-key 认证。
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
处理上传结果
- 同步上传:
is_async=false(默认),成功后从data.music_id读取音轨 ID。 - 异步上传:
is_async=true,提交成功后保存data.jobId,再通过查询任务等待任务完成。完成后的音轨 ID 位于data.data.data.musics[].musicId。
异步响应中的 status: SUCCESS 只表示任务已受理,不代表上传处理已经完成。将音轨 ID 填入风格翻唱、续写歌曲或添加人声的 music_id;任务 ID 不能替代音轨 ID。