API генерации звуковых эффектов

Обновлено 2026-09-18 · команда Suno-API

Описание эндпоинта

Генерация звуковых эффектов создаёт несколько секунд аудио, а не песню. Подходит для коротких звуков — грома, капель дождя, удара — а также для переходов, эмбиента и барабанных лупов; большинство короче 5 секунд, самый длинный — около 20 секунд. Поддерживаются режимы однократный и циклический.

Эндпоинт: POST /api/music/sounds

Оплата: Платно, сейчас по умолчанию 0,6 юаня за вызов. Фактически списанная сумма определяется текущей конфигурацией цен в бэк-офисе.

Время ожидания и тайм-ауты (важно): это синхронный эндпоинт — заказ принимается и передаётся в генерацию только при получении ответа. По измерениям большинство запросов отвечают за 1-3 секунды, около 10% занимают больше 30 секунд, а самый долгий — около 230 секунд. Установите тайм-аут клиента 300 секунд или больше; отсутствие ответа не означает, что ничего не сгенерировано, и не повторяйте запрос сразу после тайм-аута (это дублирует заказ и списывает деньги повторно). Если соединение оборвалось, проверьте позже через GET /api/music/songs. См. «Время ожидания и настройка тайм-аута» в Обзоре нового API.

Параметры запроса

Headers

Параметр	Тип	Обязательно	Примечания
Authorization	string	да	Bearer YOUR_API_KEY
Content-Type	string	да	application/json

Параметры тела запроса

Параметр	Тип	Обязательно	По умолчанию	Примечания
model	string	нет	suno-v6	Клиентское имя модели: `suno-v6`, `suno-v6-wild` или `suno-v6-mini`
description	string	да	-	Опишите нужный звук; короткие английские фразы работают наиболее стабильно, например `cinematic whoosh transition, bright impact`
title	string	нет	-	Название; если не передавать, может быть сгенерировано из описания
type	string	нет	one_shot	Тип: `one_shot` (однократный) или `loop` (циклический)
loop	boolean	нет	false	Циклическое воспроизведение; эквивалентно указанию `type` = `loop`
bpm	number	нет	-	BPM; должен быть числом больше 0. Некорректное значение возвращает 400 (`invalid_sound_bpm`), а не игнорируется молча
key	string	нет	-	Тональность в формате названия ноты (C-B) + необязательный `#`/`b` + необязательный `Major`/`Minor`, например `C Major`, `C#m`, `Bb`; пустое значение или `any` означает без ограничения. Некорректное значение возвращает 400 (`invalid_sound_key`)

Пример запроса

curl -X POST https://www.suno-api.io/api/music/sounds \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "description": "cinematic whoosh transition, bright impact",
    "title": "cinematic whoosh",
    "type": "one_shot",
    "loop": false,
    "bpm": 120,
    "key": "C"
  }'

Ответ

Возвращается массив песен; поля совпадают с общими полями ответа о песне в Обзоре нового API.

ДалееAPI генерации текста песни

Получить API-ключ

Создайте API-ключ в консоли после регистрации. Одна генерация стоит 0,6 ¥ и возвращает 2 трека, загрузки не ограничены, номер телефона не нужен.

Получить API-ключ Вернуться к обзору