Suno Music Generate
Генерация музыки с моделью Suno
Suno Music Generate
Генерация музыки от Suno: вокальные и инструментальные треки из текстового описания. Поддерживает версии V3.5–V5, custom mode с текстом песни и настройкой стиля.
Обзор
| Характеристика | Значение |
|---|---|
| ID модели | suno/generate |
| Эндпоинт | /v1/media |
| Max prompt | 5 000 символов |
| Max style | 1 000 символов |
| Max title | 80 символов |
| Версии | 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 |
Советы и лучшие практики
Асинхронная генерация
Генерация музыки - асинхронный процесс:
- Отправка запроса: POST на
/v1/mediaвозвращаетidгенерации - Проверка статуса: GET на
/v1/media/{id}возвращает текущий статус - Получение результата: когда статус
completed, в ответе будут URL аудиофайла, обложка, название и длительность трека