Кавер в другом стиле

Преобразование музыкального стиля, текста песни или голоса на основе существующего трека либо ID трека, полученного загрузкой референсного аудио.

Сначала получите ID трека через Загрузить референсное аудио либо используйте ID существующего трека и укажите его в music_id. После отправки прочитайте результат через Получить задачу.

POST/suno/mj/submit/cover

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

bearerAuth

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

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

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

Тело запроса

application/json

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

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

music_id*string

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"

persona_id?string

Persona ID.

isStorage?boolean

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

hookUrl?string

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

Тело ответа

`application/json`

curl --request POST 'https://api.agtcloud.cn/suno/mj/submit/cover' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "music_id": "MUSIC_ID",
  "custom": false,
  "mv": "chirp-v5",
  "gpt_description_prompt": "Преобразуйте это референсное аудио в ретро synth-pop с женским вокалом, сохранив запоминающуюся мелодию",
  "title": "Neon Cover",
  "tags": "synth-pop, retro, female vocal"
}'

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

Кавер в другом стиле

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

Тело запроса

Тело ответа

200application/json

`application/json`