Добавить вокал

Добавление вокального слоя к существующему аудио.

Сначала получите ID трека через Загрузить референсное аудио, затем укажите его в music_id. ID трека, возвращённый генерацией песни, не подходит для этой операции.

При custom=true поле prompt содержит текст песни или вокальный промпт. После успешной отправки сохраните data.jobId, затем ожидайте результат через Получить задачу; status: SUCCESS в ответе отправки не означает завершения генерации аудио.

POST/suno/mj/submit/add-vocals

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

bearerAuth

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

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

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

Тело запроса

application/json

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

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

music_id*string

ID трека, полученный загрузкой референсного аудио. ID трека, возвращённый генерацией песни, не подходит для этой операции.

custom*boolean

Использовать ли пользовательский режим; запрос без этого поля отклоняется.

mv?string

Версия музыкальной модели; если не указана, используется chirp-v5.

По умолчанию"chirp-v5"

Допустимые значения

"chirp-v5-5"
"chirp-v5"
"chirp-v4-5+"
"chirp-v4-5"
"chirp-v4-5-all"
"chirp-v4"
"chirp-v3-5"
"chirp-v3-0"

gpt_description_prompt?string

Обязательно при custom=false; не более 500 символов.

Длинаlength <= 500

prompt?string

Обязательно при custom=true; текст песни или вокальный промпт.

title?string

Название; не более 80 символов.

Длинаlength <= 80

tags?string

Музыкальный стиль.

negative_tags?string

Негативные теги.

style_weight?number

Диапазон значений для всех параметров: 0~1.

Диапазон0 <= value <= 1

weirdness_constraint?number

Диапазон значений для всех параметров: 0~1.

Диапазон0 <= value <= 1

audio_weight?number

Диапазон значений для всех параметров: 0~1.

Диапазон0 <= value <= 1

vocal_gender?string

Поддерживаются только Male / Female.

Допустимые значения

"Male"
"Female"

isStorage?boolean

Сохранять ли копию в хранилище.

hookUrl?string

Необязательный URL обратного вызова пользователя. Поддерживаются только порты 80, 443, 8080 и 8443; при заполнении платформа пересылает уведомления.

Тело ответа

`application/json`

curl --request POST 'https://api.agtcloud.cn/suno/mj/submit/add-vocals' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "music_id": "MUSIC_ID",
  "custom": true,
  "mv": "chirp-v5",
  "prompt": "Добавьте к этой мелодии тёплый женский вокал на китайском языке для куплетов и припева",
  "title": "Voice Layer",
  "tags": "mandopop, female vocal",
  "vocal_gender": "Female"
}'

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "jobId": "JOB_ID"
  }
}

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

Тело запроса

Тело ответа

200application/json

400application/json

`application/json`

`application/json`