Suno API: 31 режим, цены и примеры запросов

В API Hubs у Suno одна модель suno и 31 действие в поле input.action: от новой песни и звукового эффекта до отделения вокала, монтажа фрагмента и экспорта MIDI. Генерация песни (music) стоит 0,075 coin за запрос, эффект (sound) — 0,015 coin, разделение на вокал и инструментал (stems) — 0,15 coin. Цены проверены по живому каталогу 28 сентября 2026 года; 1 coin = 1 $ в тарифах, сумма в рублях зависит от курса пополнения. Ниже — карта всех режимов с ответом «когда что выбрать».

Как устроен Suno API: модель, действие и версия?

Все операции начинаются одинаково: POST /api/v1/generation/create, модель suno, объект input. Поле action выбирает работу; если его нет, выполняется music. Поле mv задаёт версию музыкального движка для совместимых операций, а custom меняет способ задания песни: простое описание или собственные слова. Это три разных решения, поэтому custom: true не заменяет action: "add-vocals", а mv: "v5.5" не говорит API, нужно ли резать трек.

Запрос возвращает taskId, а результат появляется позже. У готовой песни, дорожек и видео смотрите files; у текстов, темпа, MIDI-ссылки и созданной персоны — output. В документации задач описаны опрос статуса и вебхук. Подробная справка по музыке полезна для промптов; здесь мы разбираем всю карту действий и их сочетания.

Как создать песню, минус, текст или звуковой эффект?

Для песни с нуля выбирайте music. Если нужны собственные слова, включайте custom: true; если нужен минус без вокала — makeInstrumental: true. sound создаёт эффект по описанию и подходит для интерфейса, игры или короткого звукового акцента. lyrics пишет текст без аудио; boost-style расширяет теги стиля и тоже возвращает текст.

inspo опирается на референсы, но не обещает повторить исходную мелодию. upload сам по себе не улучшает звук. Используйте только аудио, которое вы вправе загружать и перерабатывать. Если нужен трёхсекундный сигнал для кнопки, не просите music сделать короткую песню: sound решает именно эту задачу.

Что выбрать: простой режим или собственные слова песни?

Простой режим (custom не задан или false) принимает gptDescriptionPrompt длиной до 500 символов. Опишите жанр, инструменты, настроение и тему; слова и аранжировку модель предложит сама. Для фоновой музыки, где текст не нужен, включите makeInstrumental: true: это явнее, чем фраза «без вокала» в промпте.

Custom-режим (custom: true) нужен, когда в песне должны прозвучать ваши строки. Поле prompt — текст песни или подробная инструкция, tags — жанр и звук, title — название. Не кладите «энергичный синти-поп» в prompt, если ожидаете конкретный припев: стиль относится к tags. В custom-режиме без prompt допустим makeInstrumental: true. Переключатель custom работает для music, extend и cover; у остальных действий собственные требования.

Допустимые версии mv для аудио: v3.5, v4.0, v4.5, v4.5+, v5.0, v5.5 и custom; по умолчанию стоит v4.5+. У старых v3.5/v4.0 лимиты prompt/tags — 3 000/200 символов, у более новых — 5 000/1 000. Отдельное действие lyrics принимает mv: "default" или "remi-v1". Есть и продвинутый mv: "custom": ему нужен customModel с названием и 6–24 URL обучающих аудио; модель создаётся для этого запроса, а не сохраняется между запусками. Совместимость версии с конкретным действием проверяйте по справке Suno; для первого опыта версия по умолчанию проще.

curl -X POST https://api.apihubs.ru/api/v1/generation/create \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno",
    "input": {
      "action": "music",
      "custom": false,
      "gptDescriptionPrompt": "Инструментальная заставка подкаста: мягкое фортепиано, щелчки перкуссии, спокойный темп",
      "makeInstrumental": true
    }
  }'

Этот запрос создаёт исходную дорожку. Он не задаёт точную длину заставки: нужный фрагмент удобнее получить действием crop, а конец оформить через fade-out. Оба шага стоят отдельно. Для песни со своими словами замените описание на custom: true, prompt с куплетом и tags со стилем.

Как продолжить трек, сменить стиль или добавить вокал?

Сначала дождитесь завершения исходной задачи. Передавайте её taskId как sourceTaskId; если она вернула несколько вариантов, выбирайте нужный по output.tracks[].audioId. Часть действий принимает внешний audioUrl, часть работает только с совместимой предыдущей задачей. Сохранение этих идентификаторов в своей базе избавит от ручного поиска трека при каждом шаге.

Главное различие для монтажа: extend наращивает песню, concat собирает цепочку продолжения, cover переосмысляет трек, remaster перерабатывает звучание, sample сочиняет новый материал из выделенного фрагмента. Если нужно лишь оставить 20 секунд исходника, sample не подходит — берите crop. Некоторые действия зависят от происхождения исходного трека; сначала проверьте выбранную цепочку на одной задаче, затем запускайте пакет.

Какие действия Suno заменяют простой аудиомонтаж?

Точность в секундах задают startS и endS; у временного диапазона конец должен быть позже начала. Эти операции полезны для обрезки интро, удаления лишнего куплета или плавного завершения звука.

replace-section полезен, когда сам фрагмент не подходит; remove-section вырезает его, а crop оставляет только его. Фейды не обрезают песню. У adjust-speed есть keepPitch — сохранение высоты звука, по умолчанию включено.

Как получить минус, дорожки, таймкоды и MIDI?

После генерации Suno может выдать материалы для дальнейшего монтажа. Они неодинаковы по типу: где-то скачиваются аудиофайлы, а где-то приходят значения и URL в output.

Для обычного минуса начните со stems: более дорогой stems-all нужен, если редактору требуются отдельные инструментальные группы. music-video создаёт визуализированный ролик с обложкой, а не постановочный клип с актёрами. voice можно создать из записи по voiceAudioUrl или из прежнего трека по sourceTaskId; для подтверждаемой записи нужны verificationAudioUrl, phraseId и name вместе. Созданный ID затем передают как personaId в совместимом запросе music.

Сколько стоит цепочка действий и как считать рубли?

Каждый шаг тарифицируется отдельно. Пример для заставки подкаста: music за 0,075 coin, затем crop за 0,012 coin, затем fade-out за 0,012 coin — итого 0,099 coin за эту цепочку. Если понадобились три варианта песни, сумма вырастет: не делите тариф music на число файлов, которые вернул один запрос. Для полноценного разделения на дорожки вместо монтажа добавьте stems за 0,15 coin или stems-all за 0,36 coin.

В каталоге цен coin соответствует доллару, а рублёвый эквивалент определяется курсом пополнения. Поэтому честная формула — 0,099 × курс пополнения в рублях для указанной цепочки, а не фиксированное число рублей в статье. Проверяйте актуальный курс и доступные способы оплаты в кабинете перед платежом. Для тестов хватит небольшого предоплаченного баланса; тот же ключ используется и для других моделей каталога.

Как передать готовый трек следующему действию?

После music дождитесь status: "finished", сохраните taskId и при нескольких вариантах выберите audioId нужного трека из output.tracks. Для обрезки передайте taskId как sourceTaskId:

curl -X POST https://api.apihubs.ru/api/v1/generation/create \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno",
    "input": {
      "action": "crop",
      "sourceTaskId": "ID_ЗАВЕРШЁННОЙ_ЗАДАЧИ_SUNO",
      "startS": 4,
      "endS": 24
    }
  }'

Это шаблон с местом для своего завершённого taskId. В производственном коде добавьте audioId, если исходная генерация вернула несколько треков, иначе может быть выбран первый. Статус нового задания проверяйте через GET /api/v1/task/status/{taskId} или вебхук. Полный перечень параметров и ограничений каждого режима — в справочнике действий Suno.

Частые вопросы

Сколько режимов есть у Suno API?

На 28 сентября 2026 года у модели suno через API Hubs 31 действие: генерация, развитие и монтаж музыки, работа с голосом, разбиение на дорожки, экспорт и анализ. Выбор делается полем input.action, отдельный ID модели для каждого режима не нужен.

Сколько стоит генерация песни Suno в рублях?

music стоит 0,075 coin за запрос по текущему тарифу; 1 coin = 1 $ в каталоге. Рублёвую сумму получите, умножив 0,075 на курс пополнения, показанный при оплате. Следующие действия, например crop или stems, оплачиваются отдельно.

Как сделать минус из готовой песни?

Для отделения вокала от аккомпанемента попробуйте stems с совместимым исходным треком. stems-all дороже и нужен, когда требуются разные группы инструментов, а makeInstrumental: true создаёт новую песню без вокала.

Чем cover отличается от extend и remaster?

extend продолжает песню, cover перерабатывает её в другом стиле, remaster обновляет звучание прежнего материала. Выбор зависит от того, нужно ли добавить время, сменить аранжировку или доработать звук.

Как получить текст с таймкодами и видео для соцсетей?

timestamped-lyrics возвращает данные с привязкой слов ко времени в output. music-video создаёт визуализированный MP4 на основе исходного трека; это не видеогенерация сцен по тексту. Обоим действиям нужен совместимый sourceTaskId.