Suno Music Generate

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

Suno Music Generate

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

Обзор

ХарактеристикаЗначение
ID моделиsuno/generate
Эндпоинт/v1/media
Max prompt5 000 символов
Max style1 000 символов
Max title80 символов
ВерсииV5 (по умолчанию), V4_5ALL, V4_5PLUS, V4_5, V4, V3_5

Возможности

Text-to-Music

Создание музыки по текстовому описанию

Custom Mode

Написание текста песни, выбор стиля и названия трека

Инструментал

Генерация музыки без вокала

Выбор версии

6 версий модели от V3.5 до V5

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

Простой запрос

# Создание запроса на генерацию музыки
curl -X POST "https://api.usellm.ru/v1/media" \
  -H "Authorization: Bearer <USELLM_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/generate",
    "input": {
      "prompt": "Энергичный электронный трек для тренировки с драйвовым битом"
    }
  }'

# Проверка статуса генерации
curl "https://api.usellm.ru/v1/media/{id}" \
  -H "Authorization: Bearer <USELLM_API_KEY>"

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

curl -X POST "https://api.usellm.ru/v1/media" \
  -H "Authorization: Bearer <USELLM_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": "Ночной город"
    }
  }'

Инструментальный трек

curl -X POST "https://api.usellm.ru/v1/media" \
  -H "Authorization: Bearer <USELLM_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/generate",
    "input": {
      "prompt": "Спокойная фортепианная мелодия для учёбы и концентрации",
      "style": "Ambient, Piano, Lo-fi",
      "title": "Focus Time"
    }
  }'

Параметры

ПараметрОбязательныйОписание
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

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

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

Генерация музыки - асинхронный процесс:

  1. Отправка запроса: POST на /v1/media возвращает id генерации
  2. Проверка статуса: GET на /v1/media/{id} возвращает текущий статус
  3. Получение результата: когда статус completed, в ответе будут URL аудиофайла, обложка, название и длительность трека