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

Использование

Вариант A — перепевка в заданном стиле (самый распространённый, рекомендуется) Укажите исходную песню + целевой стиль tags; о custom можно не беспокоиться (когда система видит tags, она автоматически считает это как custom=true):
Для большего контроля можно также добавить prompt (текст песни) / title. Вариант B — режим вдохновения (custom=false) Не указывайте конкретный стиль и позвольте модели импровизировать, но обязательно передайте gpt_description с описанием желаемого результата:
Выберите один из двух вариантов — не передавайте только custom=false без gpt_description (это завершится ошибкой 400 на этапе отправки).

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

Response

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