Перейти к основному содержанию
POST
Ссылка на исходный трек: для операций на основе существующей песни не нужно запоминать какие-либо вышестоящие id, достаточно передать task_id (наш task_id той задачи, которая создала исходный трек) + audio_index (какая по счёту песня в результате music[], нумерация с 1, по умолчанию 1).

Authorizations

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

Body

model
string
по умолчанию:"suno"
Аудиомодель. Сейчас передавайте suno (если не указано, по умолчанию suno).
task_id
string
обязательно
Наш task_id той задачи, которая создала исходный трек. Если отсутствует или источник не удаётся разрешить, при отправке возвращается 400.
audio_index
integer
по умолчанию:"1"
Какая по счёту песня в data.music[] результата исходной задачи (нумерация с 1; по умолчанию 1; одна генерация обычно даёт 2 песни: индексы 1 и 2).
infill_lyrics
string
Текст заменяемого фрагмента.
start_s
integer
обязательно
Начальная точка замены (секунды; сопоставляется с infill_start_s вышестоящего сервиса). Если отсутствует, сразу возвращается 400 без обращения к вышестоящему сервису.
end_s
integer
обязательно
Конечная точка замены (секунды; сопоставляется с infill_end_s вышестоящего сервиса). Если отсутствует, сразу возвращается 400 без обращения к вышестоящему сервису.
version
string
по умолчанию:"v5.5"
Версия генерации: v4 / v4.5+ / v5 / v5.5; если не указано, по умолчанию v5.5. Любое другое значение (включая v3.5 / v4.5 / v4.5-all) сразу возвращает 400 при отправке.
prompt
string
Контекстный текст песни.
title
string
Заголовок.
tags
string
Теги стиля.
negative_tags
string
Теги стиля для исключения.
Получение результата: этот эндпоинт является асинхронной задачей. После отправки вы получаете task_id; опрашивайте GET /v1/music/tasks/{task_id} с интервалом 3–5 с, пока status не станет completed или failed (генерация музыки обычно занимает 30–120 с; во время генерации statuspending, а progress идёт queued 10 → ready 50 → done 100). По завершении возьмите изменённый audio_url из data.result.music[]. При неудаче data.error.message указывает причину, а предварительно списанная квота автоматически возвращается.

Response

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