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

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).
continue_at
integer
обязательно
С какой секунды начинать продолжение.
version
string
по умолчанию:"v5.5"
Версия генерации: v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, влияет на качество звука и тарификацию; по умолчанию v5.5, если не указано, а недопустимое значение сразу возвращает 400 на этапе отправки.
custom
boolean
Передавать не нужно (для extend не проверяется). true=продление по тексту песни из prompt; false=продление по вдохновению.
prompt
string
Текст песни для продления. Действует при custom=true.
gpt_description
string
Промпт для вдохновения. Действует при custom=false или когда custom не указан (задаёт направление продления).
title
string
Заголовок. Действует только при custom=true.
tags
string
Теги стиля. Действует только при custom=true.
negative_tags
string
Теги стиля, которые нужно исключить. Действует только при custom=true.
vocal_gender
string
Пол вокала: Male / Female. Работает в обоих режимах.
style_weight
number
Вес стиля, 0.001.00 (значения вне диапазона сразу возвращают 400 на этапе отправки). Действует только при custom=true.
weirdness_constraint
number
Креативность, 0.001.00 (псевдоним weirdness). Действует только при custom=true.
audio_weight
number
Вес аудио, 0.001.00. Действует только при custom=true.
auto_lyrics
boolean
true = творчески переработать переданный текст песни. Действует только при custom=true.
persona_id
string
Идентификатор стиля Persona. Действует только при custom=true.
Получение результата: этот эндпоинт является асинхронной задачей. После отправки вы получаете task_id; опрашивайте GET /v1/music/tasks/{task_id} с интервалом 3–5 с, пока status не станет completed или failed (генерация музыки обычно занимает 30–120 с; во время генерации status равен pending, а progress меняется: в очереди 10 → готово 50 → завершено 100). По завершении возьмите продлённый audio_url из data.result.music[]. При неудаче data.error.message содержит причину, а предварительно списанная квота автоматически возвращается.

Response

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