> ## Documentation Index
> Fetch the complete documentation index at: https://speshu.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Suno Music Generate

> Генерация музыки с моделью Suno

Генерация музыки от Suno — вокальные и инструментальные треки из текстового описания. Поддерживает версии V3.5–V5, custom mode с текстом песни и настройкой стиля. Стоимость: 15 ₽ за генерацию.

<Note>
  Полная документация API: [Генерация медиа](/docs/api-reference/media/create)
</Note>

## Обзор

| Характеристика | Значение                                                 |
| -------------- | -------------------------------------------------------- |
| ID модели      | `suno/generate`                                          |
| Эндпоинт       | `/api/v1/async/media/tasks`                              |
| Max prompt     | 5 000 символов                                           |
| Max style      | 1 000 символов                                           |
| Max title      | 80 символов                                              |
| Версии         | V5 (по умолчанию), V4\_5ALL, V4\_5PLUS, V4\_5, V4, V3\_5 |
| Стоимость      | 15 ₽ за запрос                                           |

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

* **Text-to-Music**: Создание музыки по текстовому описанию
* **Custom Mode**: Написание текста песни, выбор стиля и названия трека
* **Инструментал**: Генерация музыки без вокала
* **Выбор версии**: 6 версий модели от V3.5 до V5

## Параметры

| Параметр  | Обязательный | Описание                                                                                                                                              |
| --------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model`   | Да           | `suno/generate`                                                                                                                                       |
| `prompt`  | Да           | Описание трека или текст песни (до 5 000 символов). В custom mode используется как lyrics — поддерживает теги `[Verse]`, `[Chorus]`, `[Bridge]` и др. |
| `style`   | Нет          | Жанр/стиль музыки (до 1 000 символов). Обязателен при использовании custom mode. Пример: `Pop, Electronic, Upbeat`                                    |
| `title`   | Нет          | Название трека (до 80 символов). Обязателен при использовании custom mode                                                                             |
| `version` | Нет          | Версия модели: `V5` (по умолчанию), `V4_5ALL`, `V4_5PLUS`, `V4_5`, `V4`, `V3_5`                                                                       |

## Пример запроса (cURL)

```bash theme={null} theme={null}
curl -X POST "https://speshu.ai/api/v1/async/media/tasks" \
  -H "Authorization: Bearer <SPESHU_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/generate",
    "input": {
      "prompt": "Энергичный электронный трек для тренировки с драйвовым битом"
    }
  }'
```

### Custom Mode (текст песни + стиль)

```bash theme={null} theme={null}
curl -X POST "https://speshu.ai/api/v1/async/media/tasks" \
  -H "Authorization: Bearer <SPESHU_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/generate",
    "input": {
      "prompt": "[Verse]\nГород спит, а мы не спим\nОгни мерцают в тишине\n\n[Chorus]\nМы летим, мы летим\nНад ночным городом во сне",
      "style": "Pop, Synth-pop, Dream pop",
      "title": "Ночной город"
    }
  }'
```

## Советы

**Простой режим vs Custom Mode**
В простом режиме достаточно передать `prompt` с описанием желаемой музыки — Suno сам сгенерирует текст и подберёт стиль. В custom mode вы контролируете текст песни (`prompt`), стиль (`style`) и название (`title`).

**Как писать промпты**
Описывайте настроение, жанр и инструменты: «Меланхоличная акустическая баллада с гитарой и скрипкой». Для custom mode используйте структурные теги: `[Verse]`, `[Chorus]`, `[Bridge]`, `[Outro]`.

**Выбор версии модели**
V5 — последняя и наиболее качественная версия, используется по умолчанию. Более ранние версии (V4, V3.5) могут давать другой звук — экспериментируйте при необходимости.

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

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

1. **Отправка запроса**: POST запрос на `/api/v1/async/media/tasks` возвращает `taskId`
2. **Проверка статуса**: GET запрос на `/api/v1/async/media/tasks/{task_id}` возвращает текущий статус
3. **Получение результата**: Когда статус `success`, в ответе будут URL аудиофайла, обложка, название и длительность трека