Skip to main content
POST

Authorizations

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

Body

string
по умолчанию:"suno"
Аудиомодель. Сейчас передавайте suno (если не указано, по умолчанию suno).
string
по умолчанию:"v6"
Публичная версия: v6 / v6-wild / v6-mini; по умолчанию v6.
string
обязательно
Текстовое описание звукового эффекта. Если отсутствует, на этапе отправки сразу возвращается 400 (без списания средств). Для наилучших результатов рекомендуется использовать промпты на английском языке.
string
по умолчанию:"one-shot"
Тип звукового эффекта: one-shot (по умолчанию, одиночный) / loop (зацикливаемый).
integer
Темп, 1–300; значения вне диапазона сразу возвращают 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).
string
Формат выходного аудио: mp3 / m4a / wav.
API не поддерживает пользовательские модели, Max, variety и целевую длительность.
Получение результата: API создаёт асинхронную задачу. Опрашивайте GET /v1/music/tasks/{task_id} каждые 3–5 секунд, пока status не станет completed или failed. Во время обработки он может быть pending или processing; progress — целое число от 0 до 100 без гарантии изменения с фиксированным шагом. После завершения читайте audio_url из data.result.music[]. При ошибке причина находится в data.error.message, а списанная сумма возвращается автоматически.

Response

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