Skip to main content
POST
Ссылка на исходное аудио: дополнительные ID для существующих песен не нужны. Передайте task_id исходной задачи и audio_index для выбора в data.result.music[] (с 1, по умолчанию 1).

Authorizations

string
обязательно
Все эндпоинты требуют аутентификации с использованием Bearer TokenПолучить API Key:Перейдите на страницу управления API Key, чтобы получить ваш API KeyПри использовании добавьте в заголовки запроса:

Body

string
по умолчанию:"suno"
Аудиомодель. Сейчас передавайте suno (если не указано, по умолчанию suno).
string
обязательно
Наш task_id той задачи, которая создала исходный трек. Если отсутствует или источник не удаётся разрешить, при отправке возвращается 400.
integer
по умолчанию:"1"
Выбирает дорожку из data.result.music[] исходной задачи (с 1; по умолчанию 1).
string
Текст заменяемого фрагмента.
number
обязательно
Начальная точка замены (секунды). Если отсутствует, сразу возвращается 400.
number
обязательно
Конец в секундах. Должен удовлетворять 0 ≤ start_s < end_s и не превышать известную длительность.
string
по умолчанию:"v6"
Публичная версия: v6 / v6-wild / v6-mini. По умолчанию v6; исключите при custom_model_id.
string
Полный UUID, возвращённый задачей создания модели. Несовместим с version.
string
Контекстный текст песни.
string
Заголовок.
string
Теги стиля.
string
Теги стиля для исключения.
string
Вариативность стиля: off / normal / high / extra / max. Необязательно.
boolean
по умолчанию:"false"
Включает режим Max с оплатой по двойной стандартной цене.
string
Формат выходного аудио: mp3 / m4a / wav. Endpoint не поддерживает целевую длительность.
prompt — контекст исходного текста, infill_lyrics — новый текст замены. Не отправляйте custom, instrumental, auto_lyrics и старые поля сессии редактирования.
Получение результата: дождитесь завершения задачи и прочитайте audio_url заменённой дорожки из data.result.music[]. При ошибке списанная сумма возвращается.

Response

integer
Код статуса ответа
array
Массив возвращаемых данных