Suno V6 API: выбор версии и перенос вашей интеграции

Suno V6 API в reAPI использует прежний аудиоэндпоинт с version: "V6", "V6_MINI" или "V6_WILD". При переносе старой интеграции проверьте и версию, и названия полей: интерфейс Suno теперь использует snake_case. Старое значение версии может пройти валидацию, но завершиться ошибкой при генерации.^[1]

Начните с model: "suno-music" и явно указанной версии V6. Сохраните асинхронную отправку и опрос состояния, а затем запишите идентификаторы дорожек для дальнейшего редактирования. Сначала обновите сборку запроса, потом чтение готовых результатов. Замена имени модели на suno-v6 не является документированным способом выбора V6.

Главное

• Передавайте V6, V6_MINI или V6_WILD в version; для генерации песни оставляйте ID suno-music.^[1]
• Замените старые поля camelCase на документированные имена snake_case, включая custom_mode, negative_tags и audio_id.^[1]
• Не отправляйте снятые с эксплуатации значения V4–V5.5. Принятие схемой не означает, что модель ещё генерирует аудио.^[1]
• V6 подходит как отправная точка при чётком музыкальном задании, Mini — для оценки более короткого ожидания, Wild — для поиска идей. Это рекомендации на основе описаний Suno, а не гарантии измеренной производительности.^[2]
• Закладывайте $0.06 на завершённую генерацию песни, включая два варианта. Звуковые эффекты оплачиваются отдельно: 13 кредитов.^[3]

Что меняется в запросе Suno V6 API

Suno анонсировала V6 9 сентября 2026 года: три варианта модели и переход с предыдущего поколения.^[2] Разработчику прежде всего нужно отделить анонс продукта от полей, которые действительно разрешено отправлять.

Анонс описывает более широкий набор возможностей создания и редактирования. Это не делает каждую функцию пользовательского приложения доступной в аудиозапросе reAPI. В текущем запросе генерации описаны текстовые настройки и соответствующие аудиопроцессы. Не добавляйте поле изображения или видео лишь потому, что такие входные данные упомянуты в анонсе. Ориентируйтесь на полный справочник параметров Suno.^[1]

Справочник Suno V6 показывает текущий формат запроса. model определяет операцию, version — музыкальную модель для неё. Разделите эти решения в приложении, чтобы выбор Mini случайно не переключал генерацию на редактирование.^[4]

Здесь рассматривается доступ через reAPI. Публичная форма Suno для разработчиков по-прежнему описывает исследование возможностей с отобранными партнёрами и не выдаёт производственный ключ в режиме самообслуживания.^[5]

Модели Suno API: выбор версии V6, Mini или Wild

Выбирайте по требованиям к следующему результату. Suno позиционирует основную модель как ориентированную на точность, Wild — на менее предсказуемый поиск, Mini — на более быстрое и эффективное создание. Таблица переводит эти описания в практические критерии.^[2]

Mini здесь не является более дешёвым тарифом API. Одинаковая операция стоит одинаково для всех трёх вариантов V6. Более быстрый результат сократит ожидание, а не указанную цену запроса.^[4] Для статьи не проводились контролируемые замеры задержки или сравнительное прослушивание. До собственных измерений воспринимайте слово «быстрее» как позиционирование Suno.

Для корректного сравнения оставьте промпт, режим и остальные настройки неизменными и меняйте только version. Оценивайте оба результата. Если одновременно переписать текст или изменить стиль, будет непонятно, что вызвало разницу.

Сохраняйте выбранную версию вместе с заданием. Справочник продолжения требует совпадения версии с исходной дорожкой. Переключатель для новых песен не должен незаметно перезаписывать версию последующих запросов продолжения.^[1]

Suno V6 и V5.5: переносите версии и названия полей вместе

Для существующей интеграции первое практическое различие Suno V6 и V5.5 — возможность завершить запрос. reAPI помечает V4, V4_5, V4_5PLUS, V4_5ALL, V5 и V5_5 как отключённые. Схема сохраняет эти значения, но генерация завершается ошибкой с возвратом средств.^[1]

Поэтому возможны два разных этапа отказа. Неподдерживаемое поле может быть отклонено при отправке. Принятая старая версия может сначала создать задачу, которая завершится ошибкой позднее. Проверка только HTTP-статуса POST не выявит второй случай.

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

Полный справочник фиксирует переименование полей 13 сентября 2026 года.^[1] Обновляйте объект запроса адресно. Глобальная замена текста в сохранённых результатах и других интеграциях может затронуть данные, которые переносить не нужно.

Для новых заданий сначала создайте действительный источник V6, затем проверяйте зависящие от него изменения. Выбор V6 сам по себе не превращает каждый старый ID дорожки в совместимый источник для любой операции.

Восемь операций на странице V6

Отдельная страница V6 охватывает восемь операций. Они используют POST /api/v1/audio/generations, но обязательные входные поля различаются.^[4]

Всё семейство содержит 18 асинхронных операций. Остальные десять находятся за пределами этой страницы, но не все они отклоняют поле версии. suno-replace-section принимает либо существующие task_id и audio_id, либо upload_url и version. Для загруженного аудио версия обязательна, а для существующей дорожки должна отсутствовать. Смешивать две ветви нельзя.^[1]

Если программа добавляет version ко всем запросам Suno, откажитесь от этого общего правила. Выбор версии должен оставаться только в тех конструкторах запросов, где он нужен. Конвертация WAV, создание текста и операции с голосом также имеют собственные форматы входа и выхода.

Отправьте первый запрос V6 и дождитесь аудио

Нужны ключ reAPI, достаточный баланс для операции и серверное место хранения секрета. Режим вдохновения упрощает первый запрос: prompt описывает песню, а текст сочиняет модель.^[4]

curl https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-music",
    "version": "V6",
    "custom_mode": false,
    "instrumental": false,
    "prompt": "A dreamy synthwave track about driving through a neon city at midnight"
  }'

Прочитайте id полученной задачи и подставьте его в эндпоинт задач. TASK_ID ниже — заполнитель для фактического значения:

curl "https://reapi.ai/api/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer $REAPI_API_KEY"

Успешная отправка ещё не означает готовое аудио. Продолжайте опрос, пока задача ожидает или обрабатывается; остановитесь при ошибке и используйте результат, когда status равен completed. Опрос не расходует кредиты.^[4]

Во время подготовки мы выполнили одну генерацию V6 в рабочем playground. Завершённый ответ содержал по две записи в output.audio_urls и output.tracks. Это подтверждает число результатов в данном примере, но не является тестом производительности или надёжности.

Сохраняйте output.tracks[].id, если поле есть, вместе с ID родительской задачи. URL аудио не заменяет audio_id. Справочник гарантирует URL дорожки, но пустые метаданные могут отсутствовать. До включения последующего действия предусмотрите отсутствие текста, длительности или идентификатора.^[4]

Для точного текста включите пользовательский режим и добавьте style и title. Параметр версии Suno V6 не меняет смысл custom_mode: длительность учитывается в пользовательском режиме, с целым целевым значением от 10 до 360 секунд.^[4]

Сколько стоит вызов V6

В тарифах Suno V6, проверенных 14 сентября, генерация песни стоит $0.06, или 60 кредитов, за завершённый запрос. Обе версии включены. Деление на два даёт $0.03 за возвращённую дорожку; это расчёт, а не отдельный тариф, по которому можно купить одну дорожку.^[3]

Если использовать только один вариант, пригодная песня всё равно обойдётся в $0.06. Новая генерация или последующая операция добавляет собственную плату. Выбор Mini или более короткой песни в разрешённом диапазоне не уменьшает стоимость вызова.^[4]

Со звуковыми эффектами иначе: исходная указанная ставка — $0.0125, а списание целыми кредитами составляет 13 кредитов, то есть $0.013. Для бюджета используйте списываемые кредиты, не округляйте исходную ставку вниз.^[3]

Настройка учётных данных описана в руководстве по ключу Suno API. Полная таблица цен охватывает остальные операции, а обзор официального API отдельно объясняет вопрос доступа.

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

Доступен ли Suno V6 через API?

reAPI документирует V6, V6 Mini и V6 Wild в своём эндпоинте аудиозадач. Это отдельный сервис, не форма заявки для разработчиков Suno.^[4][5]

Чем различаются три варианта?

Suno позиционирует V6 для точности, Mini для более быстрого создания, Wild для поиска идей. Выбирайте по собственным критериям приёмки; численного преимущества производительности здесь не заявлено.^[2]

Одинакова ли стоимость вариантов?

Да, для одной и той же операции reAPI. Генерация песни стоит $0.06 за завершённый запрос с любым вариантом.^[3][4]

Можно ли ещё отправлять V5_5?

Схема принимает значение, но документированный путь генерации завершается ошибкой: версия отключена. Для новых заданий используйте текущее значение V6.^[1]

Какие функции V6 требуют изменения интеграции?

Проверьте выбор версии, поля snake_case и входные данные каждой операции. Возможности пользовательского продукта из анонса не становятся параметрами API автоматически.^[1]

Можно ли не передавать version?

Из восьми операций страницы V6 — только в suno-add-vocals и suno-add-instrumental, где по умолчанию используется V6. Для генерации песни значение обязательно.^[4]

Какую длительность можно указать?

Документированный диапазон цели duration в пользовательском режиме — 10–360 секунд. В режиме вдохновения он не применяется.^[4]

Каждая операция возвращает две песни?

Нет. Пример оплаты двух вариантов относится к генерации песен. Тексты, WAV, разделение и другие операции имеют разные типы результата и требуют соответствующего разбора.^[1]

Перенесите запрос и сохраните идентификаторы дорожек

Начните с одного запроса текущей версии и проследите его до завершения. Проверьте отправленный JSON, сохраните ID задачи и дорожек, затем испытайте следующую операцию, которая действительно нужна приложению. Весь этот путь вместе с обработкой ошибок — полезный критерий приёмки миграции Suno V6 API.

Источники

1. reAPI. Suno API reference. Retrieved September 14, 2026 from reapi.ai/docs/suno.
2. Suno. Introducing v6. Published September 9, 2026; retrieved September 14, 2026 from blog.suno.com/blog/introducing-v6.
3. reAPI. Suno V6 public rate card. Retrieved September 14, 2026 from reapi.ai/models/suno-v6.
4. reAPI. Suno V6: versions, parameters and billing. Retrieved September 14, 2026 from reapi.ai/docs/suno-v6.
5. Suno. Developer API intake form. Retrieved September 14, 2026 from sunomusic.typeform.com/apiform.