Skip to main content
POST
custom задаёт интерпретацию текстовых полей. При custom=true prompt содержит текст песни и действуют title, style, negative_tags, auto_lyrics, persona_id. При custom=false prompt содержит описание идеи, а пользовательские поля игнорируются. style_weight, weirdness_constraint, audio_weight, vocal_gender проверяются и действуют в обоих режимах.
В этом endpoint используются немного другие имена: style вместо tags.

Authorizations

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

Body

string
по умолчанию:"suno"
Аудиомодель. Сейчас передавайте suno (если не указано, по умолчанию suno).
boolean
по умолчанию:"false"
false = режим вдохновения; true = пользовательский режим (prompt используется как текст песни). По умолчанию false.
boolean
по умолчанию:"false"
true = чистая музыка, без вокала. По умолчанию false.
string
Публичная версия: v6 / v6-wild / v6-mini. Требуется это поле или custom_model_id; при пользовательской модели исключите его.
string
Полный UUID созданной задачи пользовательской модели. Несовместим с version и persona_id; при его передаче применяется тариф пользовательской модели.
string
Описание идеи/текст. Обязательно при custom=false, до 3 000 символов; также обязательно при custom=true и instrumental=false, до 5 000. Для пользовательской инструментальной музыки можно не указывать.
string
Название в пользовательском режиме, до 80 символов. Игнорируется при custom=false.
string
Тег стиля в пользовательском режиме, до 1 000 символов. Игнорируется при custom=false.
string
Негативные теги стиля (стили, которых вы не хотите). Действует только при custom=true.
boolean
true = творчески переработать переданный текст песни. Действует только при custom=true.
string
ID стиля Persona. Применяется только при custom=true и несовместим с custom_model_id.
string
Пол вокала: Male / Female (также принимаются m / f / male / female, бэкенд нормализует их автоматически). Работает в обоих режимах.
number
Вес стиля, 0.001.00. Проверяется и применяется в обоих режимах.
number
Оценка креативности, 0.001.00. Проверяется и применяется в обоих режимах.
number
Вес аудио, 0.001.00. Проверяется и применяется в обоих режимах.
string
Вариативность стиля: off / normal / high / extra / max. Необязательно, фиксированного значения по умолчанию нет.
boolean
по умолчанию:"false"
Включать ли Max. Требует custom=true и оплачивается по двойной цене.
string
Формат выходного аудио: mp3 / m4a / wav. При отсутствии сервис выбирает значение по умолчанию.
integer
Целевая длительность 10–360 секунд. Только при custom=true; итоговая длительность зависит от результата задачи.
Получение результата: опрашивайте асинхронную задачу каждые 3–5 секунд. Генерация обычно занимает 30–120 секунд; статус может быть pending или processing, а прогресс не обязан меняться с фиксированным шагом. После завершения читайте audio_url из data.result.music[] (также доступны image_url, video_url, title, duration и др.). При ошибке списанная сумма возвращается.

Response

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