AGTCloud API Docs
文档指南API Reference集成与资源更新与帮助
音乐生成Suno MJ

上传参考音频

提交公开可访问的参考音频 URL,获取供翻唱、续写或添加人声使用的音轨 ID。

此接口接收 JSON 中的 audio_url,不是 Multipart 文件上传。通过 is_async 选择同步或异步处理。

POST/suno/mj/submit/upload

Authorization

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。