Suno Music Generate

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

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

Обзор

Характеристика	Значение
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)

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 (текст песни + стиль)

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, который нужно использовать для проверки статуса:

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

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

Продвинутые настройки

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

Интеграции

Обзор

Возможности

Параметры

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

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

Советы

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

​Обзор

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

​Параметры

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

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

​Советы

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

Обзор

Возможности

Параметры

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

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

Советы

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