API усиления стиля

Обновлено 2026-09-18 · команда Suno-API

Описание эндпоинта

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

Эндпоинт: POST /api/music/boost-style

Оплата: Бесплатно в пределах квоты (не более 10 вызовов в минуту и 300 в день на пользователя); сверх бесплатной квоты — 0,1 ¥ за вызов.

Определение превышения: при превышении бесплатной квоты запрос всё равно выполняется нормально, а в заголовках ответа приходят X-Suno-Helper-Free: false и X-Suno-Helper-Over-Limit: minute (или day), по ним клиент может сообщить, что этот вызов был платным.

Рекомендуемая модель: suno-v6. Доступны suno-v6, suno-v6-wild и suno-v6-mini.

Вывод на китайском: если содержимое запроса (originalTags/lyrics/user_guidance) содержит китайский и язык не задан, сервис автоматически добавляет （请用中文描述） после original_tags и дополняет user_guidance=语言：简体中文；乐器名也用中文, чтобы повысить попадание в китайские описания стиля. Фактически отправленные значения возвращаются в appliedOriginalTags и appliedUserGuidance в ответе. Если в отправленном содержимом язык уже указан явно (например «опиши на упрощённом китайском»), сервис ничего не меняет.

Аутентификация

Параметры запроса

Пример запроса

curl -X POST https://www.suno-api.io/api/music/boost-style \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "originalTags": "pop, piano, male vocal",
    "lyrics": "[Verse]\nЗа окном опускается ночь\n[Chorus]\nМы идём к свету",
    "user_guidance": "добавь суону и эрху, мужской вокал, темп быстрее",
    "instrumental": false
  }'

Ответ

{
  "code": 200,
  "message": "success",
  "data": {
    "originalTags": "pop, piano, male vocal",
    "instrumental": false,
    "upsampledStyle": "Mandopop, expressive male vocal, warm piano ballad...",
    "requestId": "request_id"
  }
}

upsampledStyle — полное описание стиля, которое следует записать обратно в поле Style.