Suno v5.5 API: гайд по генерации песен и голосам

Вы можете превратить текстовый промпт в песню примерно за 30–90 секунд, а затем передать этот файл на проверку, в хранилище и на выпуск с помощью простого API-потока.

Если свести этот гайд к главному, получится следующее:

• Я настраиваю доступ к API с ключом, заголовками и опросом (polling)

• Я выбираю правильный режим: описание, свои тексты или только музыка

• Я формирую результат короткими промптами, вокальными подсказками и продлением клипа

• Я провожу черновики через стемы, сведение, экспорт и утверждение

• Я быстро сохраняю файлы, потому что ссылки на результат могут истечь через 24–72 часа

• Я проверяю коммерческие права, записи о согласии и журналы утверждения перед выпуском

Этот гайд в основном для тех, кто хочет сделать генерацию песен частью рабочего контент-конвейера, а не просто протестировать её вручную. Это касается команд приложений, рекламных команд, продюсеров подкастов, игровых студий и монтажёров фильмов.

Несколько чисел важны сразу:

• Треки могут длиться до 240 секунд

• Первый опрос должен ждать примерно 5–10 секунд

• Опрос обычно продолжается каждые 5–10 секунд

• Ошибки превышения лимита, такие как 429, требуют короткой задержки перед повтором

• Даты для журналов утверждения следует хранить в формате США, например 07/16/2026

Что мне нравится в этой настройке, так это то, что путь простой: отправить запрос → получить task ID → опросить статус → скачать аудио → сохранить его → проверить права.

Вот короткая версия рабочего процесса:

Другими словами: речь идёт не столько о том, чтобы «сделать песню», сколько о построении повторяемой системы музыкального производства с чёткими входными данными, шагами проверки и обработкой файлов.

Настройте доступ к Suno v5.5 API для рабочего проекта

Ваш первый запрос сводится к трём вещам: учётные данные, заголовки и асинхронный опрос.

API-ключи, аутентификация и базовая структура запроса

Создайте аккаунт, затем сгенерируйте API-ключ в разделе управления ключами в панели управления. Прежде чем перейти к продакшену, задайте квоты и белые списки IP.

Никогда не прописывайте ключ жёстко в исходных файлах. Вместо этого поместите его в переменную окружения:

SUNO_API_KEY=your_key_here

Для локальной работы используйте файл .env. В продакшене используйте менеджер секретов, такой как GitHub Secrets или AWS Secrets Manager. В каждом запросе отправляйте эти заголовки:

• Authorization: Bearer YOUR_API_KEY

• Content-Type: application/json

Поток запроса довольно прост. Отправьте POST-запрос, сохраните task ID, подождите 5–10 секунд, затем опрашивайте каждые 5–10 секунд, пока задача не вернёт SUCCESS и не выдаст вам URL аудио. ^[2][7][3] В большинстве случаев генерация занимает 30–90 секунд. ^[2][3]

Как только трек готов, скачайте его или переместите в постоянное хранилище, например в бакет S3. Это важно, потому что временный URL результата может оставаться доступным недолго.

Для поля model в вашем JSON-пейлоаде явно укажите "suno-v5.5" или последний эквивалентный идентификатор, который документирует ваш провайдер. Если вам нужна определённая версия модели, не полагайтесь на значения по умолчанию.

Использование APIMart как слоя рабочего процесса

APIMart отправляет запросы Suno через единый серверный рабочий процесс, что удерживает учётные данные вне клиентского кода. Проще говоря, сырые токены не попадают на клиент, и каждый вызов проходит через один и тот же интеграционный слой.

В каждом запросе задавайте параметр model явно, чтобы запрос уходил к Suno v5.5 или к той модели, которая нужна вам на следующем шаге. Когда доступ настроен, следующая часть — это дизайн промпта и настройки вывода.

Генерируйте песни с правильным промптом, режимом и настройками вывода

Когда доступ настроен, выберите режим генерации и формат вывода прежде, чем писать промпт. В рабочих процессах Suno API custom_mode и instrumental — это основные поля, которые нужно определить заранее, до генерации аудио ^[5][8]. После этого вы можете формировать голоса и шаги проверки, чтобы превратить черновые наброски в активы, которыми действительно можно пользоваться, или интегрировать их в рабочие процессы генерации ИИ-видео.

Режим описания против режима своих текстов

Режим описания (custom_mode: false) позволяет ИИ написать тексты и выбрать музыкальный стиль из короткого текстового промпта. Он лучше всего подходит, когда вам нужен быстрый результат с лёгким управлением. Режим своих текстов (custom_mode: true) отдаёт управление вам. Вы поставляете точные тексты, теги секций, такие как [Verse], [Chorus], [Bridge] и [Outro], плюс детали стиля, такие как жанр, настроение и темп. Это делает его более подходящим для рекламы, брендированных песен и авторских треков с заданной структурой ^[5][3].

Если вы хотите только инструментальный вывод, установите instrumental: true. Затем используйте negative_tags, чтобы заблокировать нежелательный вокал, например "vocals, singing, voice" ^[6][5].

Шаблоны промптов для рекламы, брендовой музыки и авторского контента

Здесь хорошо работает простой шаблон промпта: [genre] [mood] [instruments] [voice] [era/influence]. Постарайтесь удержать его в пределах примерно 8–12 ключевых терминов, чтобы модель не сбивалась ^[3]. Слишком много смешанных сигналов может её запутать.

Режим должен соответствовать задаче. Используйте режим описания, когда стремитесь к атмосфере. Используйте режим своих текстов, когда песня должна нести сообщение, брендовую строку или историю. Вы также можете прямо указать текстуру вокала фразами вроде "soft female vocals", "deep male baritone" или "ethereal", чтобы звук соответствовал тону бренда или стилю канала ^[3][5].

Планирование вывода для продакшена

Используйте API extend, чтобы соединять клипы в более цельную песню на 2–4 минуты. Также полезно включить отдельный [Outro] или какой-то чёткий маркер окончания, чтобы трек завершался аккуратно ^[3].

Для продакшена генерируйте более одной версии, скачивайте каждую сразу же и сохраняйте инструментальный вариант рядом с любым вокальным треком. Это даёт запасной вариант, если вокальная версия не подойдёт для рекламы, монтажа или финальной проверки. Также полезно хранить каждый актив с его промптом и метаданными в одной согласованной папке проекта.

Далее уточните голоса и шаги редактирования, чтобы лучшая версия была готова к проверке.

Работа с голосами, шагами редактирования и контролем коммерческого рабочего процесса

Голоса по умолчанию, клонированные голоса и персонализированные потоки голоса

Suno v5.5 даёт вам три вокальных рабочих процесса, и выбор правильного в самом начале может сэкономить много доработок позже.

Голоса по умолчанию — самый быстрый путь. Вы описываете вокальный стиль в промпте — что-то вроде soft female vocals, ethereal или deep male baritone — и модель берёт дело на себя ^[3]. Этот вариант хорошо работает для быстрых коммерческих черновиков, когда вам не нужна одна фиксированная голосовая идентичность ^[5].

Клонированные голоса требуют больше настройки, но дают устойчивый, узнаваемый звук. Используйте клонированные голоса только тогда, когда у вас есть чёткое, задокументированное согласие владельца голоса ^[4].

Персонализированные потоки голоса идут ещё дальше. Они используют потоки редактирования Suno v5.5 и функции вроде Swap Vocals или Swap Sound, чтобы точно настроить финальный актив за несколько проходов ^[1][5].

Как только вы выбрали путь голоса, следующий шаг прост: провести черновик через редактирование и утверждение.

От черновой песни к пригодному активу

Первая генерация — это черновик. Это не готовый актив.

Рабочий процесс выглядит так: черновик → продление → разделение стемов → сведение → экспорт.

Начните с проверки текстов и тона вокала на соответствие вашему брифу. Затем разделите стемы, чтобы вокал и инструментал находились на отдельных слоях. Это даёт вашей аудиокоманде пространство для работы внутри DAW, такой как FL Studio или Ableton, где они могут применить EQ, компрессию и реверберацию. После этого экспортируйте финальную версию как WAV и прикрепите метаданные, такие как BPM, жанр и теги стиля, прежде чем сохранить её в папку проекта.

Скачивайте утверждённое аудио сразу же.

Лицензирование, коммерческое использование и внутренние проверки утверждения

Перед выпуском урегулируйте права и зафиксируйте утверждение для каждого готового трека.

Сначала подтвердите, что аккаунт, использованный для генерации песни, включает права на коммерческое использование.

Затем настройте лёгкий шаг внутреннего утверждения. Помечайте любой промпт или набор текстов, где упоминаются конкретные имена артистов или несанкционированные образы. Запросы, связанные с несанкционированными образами или именами артистов, могут быть отклонены ^[5][6]. Если вы работаете с клонированными голосовыми активами, храните записи о согласии вместе с аудиофайлом.

Для отслеживания аудита фиксируйте Task ID, название песни, длительность, теги стиля и дату утверждения для каждого финализированного актива. Используйте формат даты США — например, 07/16/2026 — и записывайте, кто её утвердил ^[5][3].

Постройте сквозной музыкальный конвейер APIMart

Простой производственный конвейер для команд

Как только ваши решения по промпту, голосу и лицензированию зафиксированы, свяжите их вместе в один повторяемый поток: бриф на входе, утверждённое аудио на выходе, затем хранение для видео, рекламы или соцсетей.

Отправьте бриф в Suno через APIMart. API возвращает task ID, и ваш слой оркестрации — такой как n8n — может запустить цикл опроса, пока задача не вернётся как SUCCESS ^[2][5]. Подождите 10 секунд перед первым опросом, чтобы не отправлять лишние запросы без причины.

Цель проста: сопоставить каждую передачу с инструментом или API, чтобы процесс шёл без того, чтобы кто-то вручную гонялся за файлами или обновлениями статуса.

Здесь важна одна деталь: URL-адреса сгенерированного аудио временны и могут истечь в течение 24–72 часов ^[5]. Поэтому ваш конвейер должен скачивать утверждённые файлы сразу же и перемещать их в постоянное хранилище до того, как это окно закроется.

После того как базовый поток заработает, добавьте маршрутизацию сбоев, чтобы отклонённые генерации возвращались на этап промпта. То же касается ответов content_policy_violation — отправляйте их обратно для изменения промпта, чтобы очередь продолжала двигаться, а не застревала ^[5].

Первые шаги

Начните с одного рабочего процесса, который можно повторять, а затем расширяйтесь только после того, как он заработает от начала до конца. Сначала выберите один сценарий использования — рекламный джингл, брендированный фоновый трек или авторский саундтрек.

Прежде чем что-либо выйдет в свет, проверьте, что ваш план чётко включает права на коммерческое использование ^[1]. Затем используйте APIMart как слой, который соединяет генерацию музыки с вашим более крупным рабочим процессом ИИ-контента, чтобы один запрос на песню мог проходить через систему, которую ваша команда сможет использовать снова и снова.

Часто задаваемые вопросы

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

Выбирайте на основе того, сколько управления вам нужно.

• Используйте режим описания, если хотите, чтобы ИИ создал тексты и композицию из текстового промпта.

• Используйте режим своих текстов, если хотите поставить собственные тексты и структуру песни.

• Используйте режим инструментала, если хотите трек без вокала, например фоновую музыку или джинглы.

Что мне следует хранить с каждым сгенерированным треком для коммерческого утверждения?

Ведите чёткую запись для каждого создаваемого трека. Как минимум храните:

• уникальный task ID

• финальный сгенерированный аудиофайл

• метаданные, такие как название песни, длительность и теги стиля или промпты

• версию модели и дату создания

Эта запись значительно облегчает проверку соблюдения лицензирования и ведение аудиторского следа для коммерческого использования.

Как не дать временным аудиоссылкам истечь в продакшене?

Аудиоссылки из Suno v5.5 API временны. В большинстве случаев они истекают в течение 24–72 часов, поэтому не подходят для долгосрочных производственных активов.

Вот более безопасный ход: как только ваш опрос статуса покажет, что задача завершилась успешно, сразу же скачайте аудиофайл и отправьте его в постоянное хранилище.

Это может быть что-то вроде:

• Google Drive

• Вашей локальной файловой системы

Если вы будете ждать слишком долго, ссылка может истечь, и файл может пропасть, когда ваше приложение попытается его получить.