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

Authorizations

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

Body

string
по умолчанию:"suno"
Аудиомодель. Сейчас передавайте suno (если не указано, по умолчанию suno).
string[]
обязательно
Массив ваших task_id для 2 исходных треков (должно быть ровно 2; любое другое количество сразу возвращает 400 при отправке).
integer[]
Массив, параллельный task_ids, выбирающий дорожку из data.result.music[] каждой задачи (с 1; значение каждого элемента по умолчанию 1).
boolean
по умолчанию:"false"
Только инструментал или нет (true=без вокала). Если не указано, по умолчанию false (с вокалом).
string
по умолчанию:"v6"
Публичная версия: v6 / v6-wild / v6-mini. По умолчанию v6; исключите при custom_model_id.
string
Полный UUID, возвращённый задачей создания модели. Несовместим с version и persona_id.
boolean
true=пользовательский режим (prompt используется как текст песни); false=режим вдохновения (используется gpt_description); если не указано, определяется по содержимому (см. предупреждение выше).
string
Обязательно при условии: передайте текст песни, если custom=true && instrumental=false. В режиме вдохновения поле не используется, но переданное значение всё равно должно соответствовать ограничению длины.
string
Промпт для вдохновения. Обязателен при custom=false — если отсутствует, запрос завершается ошибкой 400 на этапе отправки (средства не списываются).
string
Название. Действует только при custom=true.
string
Теги стиля. Действует только при custom=true.
string
Теги стиля для исключения. Действует только при custom=true.
boolean
true=креативно переписать переданный текст песни. Действует только при custom=true.
number
Вес стиля, 0.001.00 (значения вне диапазона сразу возвращают 400 при отправке). Действует только при custom=true.
number
Вес креативности от 0.00 до 1.00. weirdness_constraint — совместимый псевдоним; в новых запросах используйте weirdness.
number
Вес аудио, 0.001.00. Действует только при custom=true.
string
Пол вокала: Male / Female. Работает в обоих режимах.
string
ID стиля Persona. Применяется только при custom=true и несовместим с custom_model_id.
string
Вариативность стиля: off / normal / high / extra / max. Необязательно.
boolean
по умолчанию:"false"
Включает режим Max. Требует пользовательский режим и оплачивается по двойной стандартной цене.
string
Формат выходного аудио: mp3 / m4a / wav. Endpoint не поддерживает целевую длительность.
Получение результата: опрашивайте асинхронную задачу до завершения. Генерация обычно занимает 30–120 секунд. Читайте audio_url из data.result.music[]; при ошибке списанная сумма возвращается.

Response

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