上傳參考音訊

提交可公開存取的參考音訊 URL，取得供翻唱、續寫或加入人聲使用的音軌 ID。

此 API 接收 JSON 中的 audio_url，並非 Multipart 檔案上傳。透過 is_async 選擇同步或非同步處理。

POST/suno/mj/submit/upload

授權

bearerAuth

授權Bearer <token>

使用 Authorization: Bearer your-api-key 進行認證。

傳遞位置: header

請求主體

application/json

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

audio_url*string

可公開存取的音訊網址。

is_async?boolean

是否採用非同步上傳；預設為 false。同步成功通常會直接回傳 music_id。

預設值false

hookUrl?string

選用的使用者回呼網址。僅支援 80、443、8080、8443 連接埠；填寫後由平台轉送通知。

回應主體

`application/json`

curl --request POST 'https://api.agtcloud.cn/suno/mj/submit/upload' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "audio_url": "https://example.com/reference-vocal.wav",
  "is_async": false
}'

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "music_id": "MUSIC_ID"
  }
}

處理上傳結果

同步上傳：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。

授權

請求主體

回應主體

200application/json

400application/json

處理上傳結果

`application/json`

`application/json`