Skip to main content
POST
Исходная дорожка: источник должен быть задачей загрузки, созданной через POST /v1/music/generations/uploadTask. Передайте её task_id и выберите дорожку из data.result.music[] с помощью audio_index (с 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, возвращённая 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.00 до 1.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
Массив возвращаемых данных