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.