Перейти к основному содержанию
POST
Ссылка на исходные треки: mashup требует ровно 2 исходных трека — укажите их через task_ids (массив ровно из 2 ваших task_id), с необязательным audio_indexes (параллельный массив, указывающий, какой элемент в music[] каждой задачи, нумерация с 1, по умолчанию 1 для обоих).
custom определяет, какие поля вступают в силу: поля, указанные в неправильном режиме, молча игнорируются вышестоящим сервисом (без ошибки). При custom=true действуют prompt (текст песни), title, tags, negative_tags, auto_lyrics, style_weight, weirdness_constraint, audio_weight и persona_id, а gpt_description игнорируется; при custom=false читается только gpt_description (обязателен в этом случае — если отсутствует, при отправке возвращается 400). vocal_gender работает в обоих режимах. Если custom не указан, бэкенд определяет его в следующем порядке: есть prompttrue; prompt нет, но есть gpt_descriptionfalse; иначе есть tags/titletrue.

Authorizations

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

Body

model
string
по умолчанию:"suno"
Аудиомодель. Сейчас передавайте suno (если не указано, по умолчанию suno).
task_ids
string[]
обязательно
Массив ваших task_id для 2 исходных треков (должно быть ровно 2; любое другое количество сразу возвращает 400 при отправке).
audio_indexes
integer[]
Массив, параллельный task_ids, указывающий, какой элемент в результирующем music[] каждой задачи (нумерация с 1, по умолчанию 1).
instrumental
boolean
по умолчанию:"false"
Только инструментал или нет (true=без вокала). Если не указано, по умолчанию false (с вокалом).
version
string
по умолчанию:"v5.5"
Версия генерации: v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, влияет на качество звука и биллинг; по умолчанию v5.5, если не указано, а недопустимое значение сразу возвращает 400 при отправке.
custom
boolean
true=пользовательский режим (prompt используется как текст песни); false=режим вдохновения (используется gpt_description); если не указано, определяется по содержимому (см. предупреждение выше).
prompt
string
Текст песни. Действует при custom=true (в режиме вдохновения игнорируется).
gpt_description
string
Промпт для вдохновения. Обязателен при custom=false — если отсутствует, запрос завершается ошибкой 400 на этапе отправки (вышестоящий сервис не вызывается, средства не списываются).
title
string
Название. Действует только при custom=true.
tags
string
Теги стиля. Действует только при custom=true.
negative_tags
string
Теги стиля для исключения. Действует только при custom=true.
auto_lyrics
boolean
true=креативно переписать переданный текст песни. Действует только при custom=true.
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.
vocal_gender
string
Пол вокала: Male / Female. Работает в обоих режимах.
persona_id
string
Id стиля персоны. Действует только при custom=true.
Получение результата: этот эндпоинт является асинхронной задачей. После отправки вы получаете task_id, опрашивайте GET /v1/music/tasks/{task_id} с интервалом 3–5 с, пока status не станет completed или failed (генерация музыки обычно занимает 30–120 с; во время генерации status равен pending, а progress проходит queued 10 → ready 50 → done 100). По завершении возьмите audio_url из data.result.music[]. При неудаче data.error.message сообщает причину, а предварительно списанная квота автоматически возвращается.

Response

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