Skip to main content
POST
Исходная дорожка: источник должен быть задачей загрузки, созданной через POST /v1/music/generations/uploadTask. Передайте её task_id и выберите дорожку из data.result.music[] с помощью audio_index (с 1, по умолчанию 1). Обычная задача генерации не подходит.
custom определяет действующие поля. Любое отправленное поле обязано отвечать требованиям типа, диапазона и длины, даже если не действует в выбранном режиме. При custom=true действуют поля текста и стиля, а gpt_description игнорируется. При custom=false действует только обязательное gpt_description; его отсутствие возвращает 400. vocal_gender действует в обоих режимах. Без custom сервер выводит режим из prompt, затем gpt_description, затем tags или title.

Authorizations

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

Body

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

Response

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