Suno Sounds

Suno Sounds — инструмент Suno для создания отдельных аудиофрагментов по текстовому описанию. Звуковые эффекты, шумы окружающей среды, фоли и инструментальные сэмплы: можно запросить шум дождя, шаги, короткий переход или ударный звук. Для музыкальных заготовок доступны лупы с заданными темпом и тональностью.

Полная документация API: Генерация медиа

Функция находится в бета-версии. Точность генерации продолжает дорабатываться — описание фоновой обстановки иногда даёт музыкальное звучание, может потребоваться несколько итераций с уточнёнными формулировками.

Обзор

Характеристика	Значение
ID модели	`suno/sounds`
Эндпоинт	`/api/v1/media`
Max prompt	500 символов
Версии	V6 (по умолчанию), V6_MINI, V6_WILD
Формат результата	One Shot (одиночный звук) или Loop (зацикленный фрагмент)

Возможности

Звуковые эффекты

Короткие переходы, удары, акценты для видео и игр

Шумы и фоли

Дождь, ветер, шаги, атмосферные фоновые шумы

Музыкальные сэмплы

Ударные и инструментальные заготовки для продакшена

Лупы с BPM

Повторяющиеся фрагменты с заданным темпом и тональностью

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

Звуковой эффект

cURL
Python
TypeScript

curl -X POST "https://polza.ai/api/v1/media" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/sounds",
    "input": {
      "prompt": "Короткий металлический удар, как щелчок затвора камеры"
    }
  }'

import requests

response = requests.post(
    'https://polza.ai/api/v1/media',
    headers={'Authorization': 'Bearer <POLZA_AI_API_KEY>'},
    json={
        'model': 'suno/sounds',
        'input': {
            'prompt': 'Короткий металлический удар, как щелчок затвора камеры'
        }
    }
)
print(response.json())

const response = await fetch('https://polza.ai/api/v1/media', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <POLZA_AI_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'suno/sounds',
    input: {
      prompt: 'Короткий металлический удар, как щелчок затвора камеры'
    }
  })
});

console.log(await response.json());

Луп с темпом и тональностью

cURL
Python
TypeScript

curl -X POST "https://polza.ai/api/v1/media" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/sounds",
    "input": {
      "prompt": "Энергичный электронный бит с синтезатором и басом",
      "soundLoop": true,
      "soundTempo": 128,
      "soundKey": "Am"
    }
  }'

import requests

response = requests.post(
    'https://polza.ai/api/v1/media',
    headers={'Authorization': 'Bearer <POLZA_AI_API_KEY>'},
    json={
        'model': 'suno/sounds',
        'input': {
            'prompt': 'Энергичный электронный бит с синтезатором и басом',
            'soundLoop': True,
            'soundTempo': 128,
            'soundKey': 'Am'
        }
    }
)
print(response.json())

const response = await fetch('https://polza.ai/api/v1/media', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <POLZA_AI_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'suno/sounds',
    input: {
      prompt: 'Энергичный электронный бит с синтезатором и басом',
      soundLoop: true,
      soundTempo: 128,
      soundKey: 'Am'
    }
  })
});

console.log(await response.json());

Атмосферный фон

cURL
Python
TypeScript

curl -X POST "https://polza.ai/api/v1/media" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/sounds",
    "input": {
      "prompt": "Тихий летний лес: лёгкий ветер в листве, далёкие птицы, журчание ручья",
      "soundLoop": true
    }
  }'

import requests

response = requests.post(
    'https://polza.ai/api/v1/media',
    headers={'Authorization': 'Bearer <POLZA_AI_API_KEY>'},
    json={
        'model': 'suno/sounds',
        'input': {
            'prompt': 'Тихий летний лес: лёгкий ветер в листве, далёкие птицы, журчание ручья',
            'soundLoop': True
        }
    }
)
print(response.json())

const response = await fetch('https://polza.ai/api/v1/media', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <POLZA_AI_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'suno/sounds',
    input: {
      prompt: 'Тихий летний лес: лёгкий ветер в листве, далёкие птицы, журчание ручья',
      soundLoop: true
    }
  })
});

console.log(await response.json());

Параметры

Параметр	Тип	Обязательный	Описание
`model`	string	Да	`suno/sounds`
`prompt`	string	Да	Описание звука или фоновой музыки, до 500 символов
`version`	string	Нет	Версия модели: `V6` (по умолчанию), `V6_MINI`, `V6_WILD`
`soundLoop`	boolean	Нет	Зациклить результат. По умолчанию `false` (формат One Shot)
`soundTempo`	number	Нет	Темп в BPM (1–300). Актуален для лупов
`soundKey`	string	Нет	Тональность результата. По умолчанию `Any`. Доступные значения: `Any`, `Cm`, `C#m`, `Dm`, `D#m`, `Em`, `Fm`, `F#m`, `Gm`, `G#m`, `Am`, `A#m`, `Bm`, `C`, `C#`, `D`, `D#`, `E`, `F`, `F#`, `G`, `G#`, `A`, `A#`, `B`
`grabLyrics`	boolean	Нет	Получать lyrics/subtitles после генерации. По умолчанию `false`

Советы и лучшие практики

Конкретность формулировок

Suno рекомендует описывать звук через узнаваемые названия и характеристики. Вместо «какой-то звук» — «короткий сухой щелчок, как удар деревянной палочки по столу». Чем точнее описание, тем ближе результат к замыслу.

One Shot vs Loop

По умолчанию результат — одиночный звук (One Shot). Для повторяющегося фрагмента, который впишется в фон ролика или ритмическую основу трека, передавайте soundLoop: true. Лупы естественно сочетаются с soundTempo и soundKey.

Выбор тональности для лупов

Если заранее известна тональность проекта — укажите её в soundKey. Это упрощает последующее сведение лупа с основным треком. Если тональность не важна — оставьте Any.

Несколько итераций

Бета-статус модели означает, что с первого раза результат может не попасть в замысел. Описание фоновой обстановки иногда даёт музыкальное звучание — уточняйте формулировку и пробуйте снова.

Асинхронная генерация

Генерация звука — асинхронный процесс. После отправки запроса вы получите id, который нужно использовать для проверки статуса:

Отправка запроса

POST запрос на /api/v1/media возвращает id генерации.

Проверка статуса

GET запрос на /api/v1/media/{id} возвращает текущий статус.

Получение результата

Когда статус completed, в ответе будут URL аудиофайла и метаданные сгенерированного звука.

Следующие шаги

Статус генерации

Проверка статуса генерации медиа

Suno Music Generate

Полноценная генерация музыки с вокалом и текстом песни

Начало работы

Продвинутое

Классификация и оценка

Генерация медиа

Интеграции

Обзор

Возможности

Звуковые эффекты

Шумы и фоли

Музыкальные сэмплы

Лупы с BPM

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

Звуковой эффект

Луп с темпом и тональностью

Атмосферный фон

Параметры

Советы и лучшие практики

Асинхронная генерация

Следующие шаги

Статус генерации

Suno Music Generate

​Обзор

​Возможности

Звуковые эффекты

Шумы и фоли

Музыкальные сэмплы

Лупы с BPM

​Примеры запросов

​Звуковой эффект

​Луп с темпом и тональностью

​Атмосферный фон

​Параметры

​Советы и лучшие практики

​Асинхронная генерация

​Следующие шаги

Статус генерации

Suno Music Generate

Обзор

Возможности

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

Звуковой эффект

Луп с темпом и тональностью

Атмосферный фон

Параметры

Советы и лучшие практики

Асинхронная генерация

Следующие шаги