Skip to main content
POST
Ссылка на исходный трек: для операций на основе существующей песни не нужно запоминать какие-либо дополнительные id, достаточно передать task_id (task_id той задачи, которая создала исходный трек) + audio_index (какая по счёту песня в результате music[], нумерация с 1, по умолчанию 1).
У этого эндпоинта нет измерения версии: не передавайте version — если он передан, он игнорируется и не влияет на тарификацию.

Authorizations

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

Body

string
по умолчанию:"suno"
Аудиомодель. Сейчас передавайте suno (если не указано, по умолчанию suno).
string
обязательно
Наш task_id той задачи, которая создала исходный трек. Если он отсутствует или источник не удаётся разрешить, при отправке возвращается 400.
integer
по умолчанию:"1"
Какая по счёту песня в data.music[] результата исходной задачи (нумерация с 1; по умолчанию 1; одна генерация обычно даёт 2 песни: индексы 1 и 2).
integer
обязательно
Длительность нарастания (секунды). Если отсутствует, сразу возвращается 400.
string
по умолчанию:"Untitled"
Название (по умолчанию Untitled).
Получение результата: этот эндпоинт является асинхронной задачей. После отправки вы получаете task_id, опрашивайте GET /v1/music/tasks/{task_id} с интервалом 3–5 с, пока status не станет completed или failed (обычно занимает 30–120 с; во время генерации statuspending, а progress проходит в очереди 10 → готово 50 → завершено 100). По завершении возьмите обработанный audio_url из data.result.music[]. При неудаче data.error.message содержит причину, а предварительно списанная квота автоматически возвращается.

Response

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