Style boost API

Updated 2026-09-18 · Suno-API team

Endpoint description

Style boost expands a short style tag into a fuller style description that suits Suno generation better, and can also generate a style passage from complete lyrics.

Endpoint: POST /api/music/boost-style

Billing: Free within the quota (at most 10 calls per minute and 300 per day for each user); beyond the free quota it is charged at 0.1 ¥ per call.

Detecting over-limit: when the free quota is exceeded the request still runs normally, and the response headers carry X-Suno-Helper-Free: false and X-Suno-Helper-Over-Limit: minute (or day), so the client can tell the user this call was billed.

Recommended model: suno-v6. suno-v6, suno-v6-wild and suno-v6-mini are available.

Chinese output: when the request content (originalTags/lyrics/user_guidance) contains Chinese and no language is declared, the service automatically appends （请用中文描述） after original_tags and adds user_guidance=语言：简体中文；乐器名也用中文, to raise the hit rate of Chinese style descriptions. The values actually sent are returned in appliedOriginalTags and appliedUserGuidance in the response. If the content you send already states a language (for example "describe in Simplified Chinese"), the service makes no changes at all.

Authentication

Request parameters

Request example

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]\nNight falls outside the window\n[Chorus]\nWe walk towards the light",
    "user_guidance": "add suona and erhu, male vocal, faster tempo",
    "instrumental": false
  }'

Response

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

upsampledStyle is the complete style description that should be written back into the Style input box.