Загрузить референсное аудио

Отправка общедоступного URL референсного аудио для получения ID трека, используемого для каверов, продолжения песни или добавления вокала.

Этот интерфейс принимает audio_url в JSON, а не файл Multipart. Выберите синхронную или асинхронную обработку через is_async.

POST/suno/mj/submit/upload

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте Authorization: Bearer your-api-key для аутентификации.

Расположение: header

Тело запроса

application/json

Определения типов TypeScript

Используйте тип request body в TypeScript.

audio_url*string

Общедоступный URL аудио.

is_async?boolean

Использовать ли асинхронную загрузку; по умолчанию false. При успешной синхронной загрузке обычно сразу возвращается music_id.

По умолчаниюfalse

hookUrl?string

Необязательный URL обратного вызова пользователя. Поддерживаются только порты 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 (по умолчанию); после успеха прочитайте ID трека из data.music_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`