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

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).
number
обязательно
Секунда начала продолжения: не меньше 1 и меньше фактической длительности исходной дорожки; поддерживаются дробные значения.
string
по умолчанию:"v6"
Публичная версия: v6 / v6-wild / v6-mini. По умолчанию v6; исключите при custom_model_id.
string
Полный UUID, возвращённый задачей создания модели. Несовместим с version и persona_id.
boolean
по умолчанию:"true"
true = продолжить текстом из prompt; false = продолжение по идее. По умолчанию true.
string
Текст песни для продления. Действует при custom=true.
string
Описание идеи. Действует только при явном custom=false и задаёт направление продолжения.
string
Заголовок. Действует только при custom=true.
string
Теги стиля. Действует только при custom=true.
string
Теги стиля, которые нужно исключить. Действует только при custom=true.
string
Пол вокала: Male / Female. Работает в обоих режимах.
number
Вес стиля, 0.001.00 (значения вне диапазона сразу возвращают 400 на этапе отправки). Действует только при custom=true.
number
Вес креативности, 0.001.00. Старое имя weirdness_constraint поддерживается; в новых запросах используйте weirdness.
number
Вес аудио, 0.001.00. Действует только при custom=true.
boolean
true = творчески переработать переданный текст песни. Действует только при custom=true.
string
ID стиля Persona. Применяется только при custom=true и несовместим с custom_model_id.
integer
Целевая длительность 10–360 секунд. Только при custom=true; фактическая длительность зависит от результата.
string
Вариативность стиля: off / normal / high / extra / max. Необязательно.
boolean
по умолчанию:"false"
Включать ли Max. Требует custom=true и оплачивается по двойной цене.
string
Формат выходного аудио: mp3 / m4a / wav.
Результат: дождитесь асинхронного завершения и прочитайте audio_url продлённой дорожки из data.result.music[]. При ошибке списанная сумма возвращается.

Response

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