# Suno Music Generate

> Создаёт вокальные песни и инструментальные композиции по текстовому описанию; подходит для музыкальных набросков, идей и контента.

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

## Описание

#### Суть
Модель создаёт музыку по текстовому описанию: можно задать жанр, настроение, звучание или тему песни. В справке Suno описан простой сценарий, где пользователь пишет, что хочет услышать, а сервис генерирует песню; также доступен режим с пользовательским текстом. Можно запросить вокальную композицию или инструментальный вариант.

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

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

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

## Цены

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

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

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

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

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

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

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

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

- `prompt` (обязательный): Описание или текст песни. Для V6: до 3000 символов в обычном режиме, до 5000 в custom mode
- `duration`: Длительность в секундах, только в custom mode
- `style`: Жанр/стиль музыки (обязателен в custom mode)
- `title`: Название трека (обязателен в custom mode)
- `version`: Версия модели Suno. По умолчанию V6. Значения: V6, V6_MINI, V6_WILD. По умолчанию: V6
- `personaId`: ID персоны или голоса, только в custom mode
- `customMode`: Расширенный режим с собственным текстом песни. По умолчанию: false
- `audioWeight`: Вес аудио, до двух знаков после запятой
- `vocalGender`: Пол вокалиста. Значения: m, f
- `instrumental`: Инструментальная музыка без вокала. По умолчанию: false
- `personaModel`: Тип персоны, только в custom mode. Значения: style_persona, voice_persona

## Ссылки

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