APIMart
APIMart

Как использовать Suno v5.5: песни и голоса ИИ

Пошаговый гайд по Suno v5.5: настройте доступ, генерируйте песни по режимам, управляйте голосами, продлевайте клипы, храните файлы и проверяйте права.

Туториал

9 сентября 2026 года Suno заменила v5.5 моделями V6, но процесс из этого руководства по-прежнему работает: отправляете текстовый промпт, опрашиваете задачу и передаёте файл на проверку, хранение и публикацию. Через Suno API на APIMart теперь вызываются v6, v6-wild или v6-mini, а не v5.5 (Suno: Introducing v6).

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

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

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

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

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

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

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

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

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

  • В пользовательском режиме duration принимает 10–360 секунд, а итоговая длина зависит от результата

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

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

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

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

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

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

ШагЧто я делаю
ДоступДобавить API-ключ, заголовок авторизации и тело JSON
ГенерацияОтправить промпт с нужным режимом и моделью
ГолосИспользовать промпты голоса по умолчанию, клонированные голоса или отредактированные потоки голоса
РедактированиеПродлить клипы, разделить стемы, свести и экспортировать
ПроверкаПроверить тексты, использование образа и коммерческие условия
ХранилищеСохранить утверждённые файлы MP3/WAV в S3, Drive или другое постоянное место

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

APIMart
[Suno](https://suno.com/home) v5.5 API Music Pipeline: From Prompt to Published Track

Главное

  • 9 сентября 2026 года Suno заменила v5.5 моделями V6, V6 Wild и V6 Mini; в APIMart вы отправляете model: "suno" и указываете version: v6, v6-wild или v6-mini.
  • Процесс асинхронный: POST /v1/music/generations возвращает ID задачи, затем вы опрашиваете GET /v1/music/tasks/{task_id}, пока status не станет completed, и читаете data.result.music[].audio_url.
  • Режим вдохновения (custom: false) пишет песню по описанию, пользовательский режим (custom: true) берёт ваш собственный текст с тегами вроде [Verse] и [Chorus], а instrumental: true убирает вокал.
  • Подождите около 3 секунд перед первым опросом, затем проверяйте каждые 5–10 секунд; при ошибке 429 сделайте паузу перед повторной попыткой.
  • Количество возвращаемых треков не фиксировано, а результаты хранятся 72 часа, поэтому сразу скачивайте одобренные файлы, проверяйте права на коммерческое использование и храните согласия для клонированных голосов.

Suno V6: кратко

ПараметрЗначение
Тип моделиГенерация песен ИИ через асинхронный API (ID задачи, затем опрос статуса)
Входные данныеТекстовый промпт; свой текст песни с тегами [Verse]/[Chorus]/[Bridge]/[Outro]; теги стиля; instrumental: true
ВыходПосле того как status стал completed, у каждого трека в data.result.music[] есть audio_url; audio_format — mp3, m4a или wav
Длина клипаduration от 10 до 360 секунд в пользовательском режиме; фактическая длина зависит от результата
Ключевые возможностиРежимы вдохновения, пользовательский и инструментальный; vocal_gender; Personas и пользовательские модели
ДоступSuno API в APIMart: model: "suno" плюс version (v6 / v6-wild / v6-mini) или custom_model_id; авторизация по Bearer-ключу API
Лучше всего подходитРекламные джинглы, брендовые песни, саундтреки для авторов, подкасты, фоновая музыка
ОграниченияРезультаты хранятся 72 часа; число треков на задачу не фиксировано; запросы с именами артистов или несанкционированным сходством могут быть отклонены

Настройте доступ к Suno V6 для рабочего проекта

APIMart

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

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

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

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

SUNO_API_KEY=your_key_here

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

  • Authorization: Bearer YOUR_API_KEY

  • Content-Type: application/json

Схема запросов простая. Отправьте POST https://api.apimart.ai/v1/music/generations, сохраните полученный task_id, подождите около 3 секунд и опрашивайте GET /v1/music/tasks/{task_id} каждые 5–10 секунд, пока status не станет completed или failed. После завершения читайте каждый audio_url из data.result.music[] и не рассчитывайте на фиксированное число треков. При failed причина указана в data.error.message, а списание возвращается автоматически (документация APIMart: генерация музыки, правила задач).

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

Код ошибкиЗначениеЧто делать
401UnauthorizedПроверьте ключ.
402Требуется оплатаПополните баланс APIMart.
429Превышен лимит запросовСделайте короткую паузу и повторите.
502Ошибка вышестоящего сервисаПовторите позже, но не отправляйте платный запрос вслепую повторно после таймаута.

В JSON-теле запроса задайте model как "suno" и явно выберите version: v6 (флагман), v6-wild (более разнообразные результаты) или v6-mini (быстрее). v5.5 больше недоступна: с запуском V6 Suno вывела предыдущие модели из работы. Если вы используете пользовательскую модель, передавайте custom_model_id вместо version — совмещать их нельзя.

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

APIMart

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

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

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

Когда доступ настроен, выберите режим генерации и формат вывода до того, как писать промпт. В APIMart заранее решаются два поля — custom и instrumental, а audio_format задаёт mp3, m4a или wav. После этого можно настроить вокал и шаги проверки, чтобы превратить черновики в пригодные материалы, например саундтреки для видеопроектов.

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

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

РежимСкоростьУправлениеНаиболее подходящий сценарийТребуемый ввод
ОписаниеСамый быстрыйНизкое (управляется ИИ)Фоновые треки, lo-fi биты, создание настроенияКороткий описательный промпт
Свои текстыМедленнееВысокое (задаётся пользователем)Рекламные джинглы, брендированные песни, сторителлингПолные тексты + теги стиля + название
ИнструменталБыстрыйСреднееПодкасты, видеопереходы, эмбиент-подложкиТеги стиля + instrumental: true

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

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

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

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

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

Чтобы управлять длиной, задайте duration (10–360 секунд) в пользовательском режиме и проверьте фактическую duration в результате: целевое значение не гарантируется. Чтобы продлить готовый трек, используйте эндпоинт продолжения POST /v1/music/generations/extend (документация APIMart: продолжение и продление). Отдельный [Outro] или чёткая метка концовки помогает треку аккуратно завершиться.

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

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

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

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

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

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

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

Персонализированные голосовые сценарии идут ещё дальше. В Suno Personas доступны только в Premier, а пользовательские модели — и в Pro, и в Premier (страница цен Suno). Через APIMart передаётся persona_id (только в пользовательском режиме) или custom_model_id, и в одном запросе их использовать нельзя (документация APIMart).

Тип голосаСогласованность брендаУсилия на настройкуПотребности в управлении
Голоса по умолчаниюНа основе промптаМинимальныеНизкие — стандартные права ИИ
Клонированные голосаВысокая — конкретный образУмеренные — нужны обучающие данныеВысокие — нужны согласие и юридические документы
ПерсонализированныеОчень высокая — кастомные моделиВысокие — итеративное редактированиеУмеренные — нужно внутреннее утверждение

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

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

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

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

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

Шаг продакшенаДействиеИнструменты
Создание черновикаСгенерировать начальный клип с хукомSuno V6 API, структурированные тексты
ПродлениеДостичь нужной длиныduration в пользовательском режиме или эндпоинт продолжения POST /v1/music/generations/extend
ДоработкаРазделить вокал и инструменталAPI разделения стемов
Пост-продакшнСведение, EQ, Auto-TuneDAW (FL Studio, Ableton)
ЭкспортКонвертировать в WAV, прикрепить BPM и жанрТегирование метаданных, конвертация в WAV

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

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

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

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

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

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

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

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

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

Отправьте бриф в Suno через APIMart. API возвращает ID задачи, а ваш оркестратор — например, n8n — может крутить цикл опроса, пока status не вернётся как completed или failed. Подождите около 3 секунд перед первым опросом, чтобы не отправлять лишние запросы.

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

Этап рабочего процессаИнструмент / APIКлючевое действие
БрифингLLMСгенерировать тексты и теги стиля из темы
ГенерацияAPI генерации Suno (APIMart)Отправить POST-запрос с промптом и режимом
Отслеживание статусаЦикл опроса n8nПроверять статус задачи каждые 5–10 секунд
Проверка человекомФорма проверкиУтвердить или отклонить перед хранением
ХранилищеGoogle Drive / S3Скачать и сохранить MP3/WAV с метаданными
ПродакшнМонтажный пакетИмпортировать аудио в видео- или рекламные шаблоны

Здесь важна одна деталь: APIMart хранит результаты генерации 72 часа. Поэтому конвейер должен сразу скачивать одобренные файлы и переносить их в постоянное хранилище, пока это окно не закрылось.

Когда базовый процесс заработает, добавьте маршрутизацию ошибок, чтобы отклонённые генерации возвращались на этап промпта. Если задача завершилась со статусом failed, прочитайте data.error.message, поправьте промпт и отправьте заново. APIMart автоматически возвращает средства за неудачные задачи, так что очередь продолжает двигаться и не застревает.

Первые шаги

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Результаты Suno API в APIMart хранятся только 72 часа, поэтому ссылки на результаты не подходят для долгосрочных производственных материалов.

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

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

  • Google Drive

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

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

Теги#Suno v5.5#Suno API#генерация песен ИИ#музыкальный API#коммерческие права на музыку

О команде APIMart

Команда APIMart пишет обзоры моделей, сравнения и разборы цен для разработчиков, которые создают продукты на базе ИИ. APIMart даёт один API для моделей чата, изображений и видео от разных провайдеров, поэтому модели из этой статьи можно сравнить между собой до запуска.

Готовы попробовать?

Выберите нужную модель в маркетплейсе моделей

Попробуйте чат, изображения и видео в маркетплейсе APIMart и быстро оцените возможности моделей через единый API.

Чат-моделиМодели изображенийВидео-модели
Открыть маркетплейс моделей