Skip to main content
POST

Authorizations

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

Body

string
по умолчанию:"suno"
Аудиомодель. Сейчас передавайте suno (если не указано, по умолчанию suno).
string
по умолчанию:"v5.5"
Версия генерации: только v5 / v5.5; если не указано, по умолчанию v5.5.
string
обязательно
Текстовое описание звукового эффекта. Если отсутствует, на этапе отправки сразу возвращается 400 (без списания средств). Для наилучших результатов рекомендуется использовать промпты на английском языке.
string
по умолчанию:"one-shot"
Тип звукового эффекта: one-shot (по умолчанию, одиночный) / loop (зацикливаемый).
integer
Темп, 1300; значения вне диапазона сразу возвращают 400 на этапе отправки.
string
Перечисление тональностей: мажорные тональности C / C# / D / D# / E / F / F# / G / G# / A / A# / B; для минорных добавляется m (Cm / C#m / … / Bm). Поддерживается только запись с диезами (#); бемоли (Db / Eb и т. д.) и B# возвращают 400 (key param error).
Получение результата: этот эндпоинт является асинхронной задачей. После отправки вы получаете task_id; опрашивайте GET /v1/music/tasks/{task_id} с интервалом 3–5 с, пока status не станет completed или failed (во время генерации status равен pending, а progress меняется: в очереди 10 → готово 50 → завершено 100). По завершении возьмите audio_url из data.result.music[]. При неудаче data.error.message содержит причину, а предварительно списанная квота автоматически возвращается.

Response

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