Перейти к основному содержанию
POST

Authorizations

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

Body

model
string
по умолчанию:"suno"
Аудиомодель. Сейчас передавайте suno (если не указано, по умолчанию suno).
version
string
по умолчанию:"v5.5"
Версия генерации: только v5 / v5.5; если не указано, по умолчанию v5.5.
prompt
string
обязательно
Текстовое описание звукового эффекта (сопоставляется с вышестоящим sound). Если отсутствует, на этапе отправки сразу возвращается 400 (без обращения к вышестоящему сервису и без списания средств).
type
string
по умолчанию:"one-shot"
Тип звукового эффекта: one-shot (по умолчанию, одиночный) / loop (зацикливаемый).
bpm
integer
Темп, 1300; значения вне диапазона сразу возвращают 400 на этапе отправки.
key
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

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