Suno — нейросеть, которая пишет готовую песню по текстовому описанию: музыку, вокал и текст. Через PlusVibe API Suno доступна из России как обычный HTTP-эндпоинт: один ключ, баланс в рублях, счёт и закрывающие документы для юрлиц. Ниже — что именно умеет Suno в нашем каталоге, как отправить первый запрос и сколько это стоит.
Что можно делать с Suno через API
В каталоге медиа-моделей Suno — это не одна модель, а семейство операций. Удобно разделить их на три группы.
Создать трек с нуля
- suno — главная модель: песня или инструментал по описанию. Версии
v6(по умолчанию),v6-wild(смелее и ярче) иv6-mini(быстрее и легче). - suno-lyrics — только текст песни по описанию, без музыки. Удобно, чтобы сначала согласовать слова, а потом уже генерировать трек.
- suno-style-boost — превращает короткое описание стиля («синтвейв, ночь, дождь») в развёрнутый промпт. Ответ приходит сразу, без очереди.
- suno-sfx — звуковые эффекты по описанию: можно задать зацикливание, темп и тональность.
Доработать свой звук
Эти операции принимают ссылку на ваше аудио (upload_url):
- suno-extend-audio — продолжить загруженный трек;
- suno-cover-audio — сделать кавер на загруженное аудио;
- suno-add-vocals — дописать вокал к готовой инструментальной дорожке;
- suno-add-instrumental — наоборот, дописать аккомпанемент к вокалу;
- suno-mashup — свести два трека в один (нужно ровно две ссылки);
- suno-stem — разделить аудио на вокал и инструментальные стемы.
Работать с уже сгенерированным треком
Эти операции ссылаются на исходную генерацию Suno: заменить фрагмент (suno-replace-section), сделать кавер (suno-cover-generate), получить WAV (suno-wav), MIDI (suno-midi), текст с таймкодами по словам (suno-timestamped-lyrics), видеоряд к треку (suno-music-video) или персону — сохранённый голос и стиль (suno-persona). Какие поля нужны каждой операции, показано в её карточке в каталоге медиа-моделей.
Первый запрос: песня по описанию
Музыка генерируется асинхронно: вы создаёте задачу, получаете jobId и опрашиваете статус, пока трек не будет готов. Схема та же, что у видео и изображений, — подробно она описана в разделе «Генерация медиа».
# 1. Создаём задачу
curl -X POST https://plusvibeapi.ru/api/media/generate \
-H "Authorization: Bearer sk-pv-ВАШ_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{
"model": "suno",
"prompt": "Лёгкая инди-поп песня о первом снеге в городе, тёплый женский вокал",
"opts": { "version": "v6" }
}'
# → HTTP 202: {"ok":true,"jobId":"...","status":"processing", ...}
# 2. Опрашиваем статус раз в несколько секунд
curl https://plusvibeapi.ru/api/media/jobs/JOB_ID \
-H "Authorization: Bearer sk-pv-ВАШ_КЛЮЧ"
# Готово: {"status":"success","resultUrls":["https://..."], "priceRub": ...}Когда статус станет success, в resultUrls придут ссылки на аудио. Скачайте файлы к себе — не стройте продукт на том, что ссылка будет жить вечно.
Полезные параметры в opts
instrumental: true— без вокала, только музыка. Подходит для фона к видео и подкастам.styleиtitle— жанр и название. Если их передать, генерация идёт в «расширенном» режиме: промпт воспринимается как основа для текста, а стиль задаётся отдельно.negativeTags— чего в треке быть не должно («тяжёлые гитары, электроника»).vocalGender—mилиf.duration— длительность от 10 до 360 секунд; работает у версий V6 в расширенном режиме, то есть вместе соstyleилиtitle.styleWeight,weirdnessConstraint,audioWeight— числа от 0 до 1: насколько строго держаться стиля, насколько экспериментировать, насколько опираться на референсное аудио.
Если писать код пока не хочется, те же модели доступны в Нейростудии в личном кабинете (/dashboard/studio): выбираете модель, заполняете поля, цену видите до запуска.
Сколько стоит Suno по API
Цены ориентировочные и сверены с каталогом 25 сентября 2026 года. Точную цену конкретной конфигурации показывает калькулятор на странице модели, а итоговое списание приходит в поле priceRub статуса задачи.
Две детали, которые важно знать заранее. Версия внутри suno на цену не влияет: V6, V6 Wild и V6 Mini стоят одинаково. А у suno-stem цена зависит от режима: простое отделение вокала дешевле, чем полное разделение на стемы, и каждый вызов оплачивается отдельно.
Если задача завершилась ошибкой (status: "fail"), деньги не списываются. При этом повторный POST /api/media/generate — это новая задача: после таймаута сначала проверьте статус старого jobId, а не отправляйте запрос заново вслепую.
Где пригодится
- Фоновая музыка для видео и рекламы. Инструментал нужной длины под ролик, без поиска стоков. В паре с видеомоделями — см. Kling API и Wan API.
- Джинглы и звуковые логотипы. Короткие треки с заданным стилем, а для кнопок и уведомлений —
suno-sfx. - Персональные песни. Сервисы поздравлений: пользователь вводит имя и повод,
suno-lyricsпишет текст,suno— песню. - Работа с готовыми записями. Отделить вокал от минуса, продолжить демо, получить MIDI для аранжировки в DAW.
Если нужен голос без музыки — диктор, озвучка статьи, голосовой бот, — берите модели синтеза речи: о них отдельная статья «TTS API: озвучка текста нейросетью».
Оплата и документы
Баланс пополняется в рублях, генерации списываются с него же. Юрлица и ИП могут платить по счёту и получать закрывающие документы; условия — в договоре.
Честные ограничения
- Время. Трек генерируется не мгновенно: закладывайте опрос статуса и таймауты на своей стороне.
- Результат зависит от промпта. Модель может не попасть в стиль или спеть не то слово. Закладывайте несколько попыток на трек, который пойдёт в продакшен.
- Права и содержание. Условия использования результатов устанавливает разработчик модели; PlusVibe — шлюз к модели, а не правообладатель. Спорные по содержанию запросы модель может отклонить.
Итог
Suno через PlusVibe — это полный цикл работы с музыкой по API: текст, трек, доработка, стемы и экспорт. Одна схема запросов для всех операций, цены в рублях и документы для бухгалтерии. Актуальный состав операций и параметров отдаёт медиа-каталог, а ключ и Нейростудия — в личном кабинете.
