# Suno Sounds

> Создаёт по текстовому описанию отдельные звуковые эффекты, инструментальные сэмплы и атмосферные аудиофрагменты для музыки, видео и игр.

- **ID для API:** `suno/sounds`
- **Тип Модели:** Модель генерации музыки

## Описание

#### Суть
Инструмент Suno для создания отдельных аудиофрагментов по текстовому описанию. Он рассчитан не только на музыкальные элементы: можно запросить звуковые эффекты, шумы окружающей среды, фоли и инструментальные сэмплы. Например, это могут быть короткий звуковой переход, шум дождя, шаги или ударный звук. Для музыкальных заготовок доступны лупы, в том числе с заданными темпом и тональностью.

#### Сильные стороны
Задача описывается обычным текстом, без необходимости записывать звук или собирать его вручную. В настройках можно выбрать формат One Shot для одиночного звука или Loop для повторяющегося фрагмента; для лупов можно указать BPM и тональность. Такой набор подходит как для поиска отдельного звукового акцента, так и для создания заготовок, которые можно включить в музыкальный или аудиовизуальный проект.

#### Типовые сценарии
Сервис можно использовать для эскизов звукового оформления роликов и игр, переходов и спецэффектов, атмосферных фоновых шумов, фоли, а также ударных и других музыкальных сэмплов. Лупы могут пригодиться для повторяющегося музыкального фона или ритмической основы. Если результат не совпал с замыслом, описание можно уточнить и попробовать снова: Suno рекомендует формулировать запрос конкретно, используя узнаваемые названия звуков и их характеристики.

#### Ограничения
В справке Suno функция обозначена как экспериментальная и находящаяся в бета-версии; точность генерации продолжает дорабатываться. Поэтому результат может не полностью соответствовать запросу: например, описание фоновой обстановки иногда приводит к музыкальному звучанию. Возможно, потребуется несколько итераций с более точными формулировками. Генерация предназначена для создания аудиофрагментов по описанию, а не для гарантированного воспроизведения конкретной записи или точного звука.

## Цены

- Генерация (2 трека): 2 ₽

## Провайдеры

Выбрать Провайдера можно параметром `provider` в запросе.

| Провайдер | Цена | Контекст | Макс. ответ | Данные в РФ | 152-ФЗ |
| --- | --- | --- | --- | --- | --- |
| mie | Генерация (2 трека): 2 ₽ | — | — | — | — |

## Быстрый старт

```bash
curl https://polza.ai/api/v1/media \
  -H "Authorization: Bearer $POLZA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "suno/sounds",
  "input": {
    "prompt": "Опишите, что нужно сгенерировать"
  }
}'
```

Ответ приходит со статусом `pending`; результат — `GET https://polza.ai/api/v1/media/{id}`.

Параметры `input`:

- `prompt` (обязательный): Описание звука или фоновой музыки, до 500 символов
- `version`: Версия модели Suno. По умолчанию V6. Значения: V6, V6_MINI, V6_WILD. По умолчанию: V6
- `soundKey`: Тональность результата. Значения: 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. По умолчанию: Any
- `soundLoop`: Зациклить результат. По умолчанию: false
- `grabLyrics`: Получать lyrics/subtitles после генерации. По умолчанию: false
- `soundTempo`: Темп в BPM

## Ссылки

- Страница: https://polza.ai/models/suno/sounds
- Каталог: https://polza.ai/models