API för stilförstärkning

Uppdaterad 2026-09-18 · Suno-API-teamet

Beskrivning av ändpunkten

Stilförstärkning expanderar en kort stiltagg till en fullständigare stilbeskrivning som passar Suno-generering bättre, och kan även generera ett stilavsnitt utifrån en fullständig låttext.

Ändpunkt: POST /api/music/boost-style

Fakturering: Gratis inom kvoten (högst 10 anrop per minut och 300 per dag per användare); över den kostnadsfria kvoten kostar det 0,1 ¥ per anrop.

Upptäcka överskridande: när den kostnadsfria kvoten överskrids körs begäran ändå normalt, och svarshuvudena innehåller X-Suno-Helper-Free: false och X-Suno-Helper-Over-Limit: minute (eller day), så klienten kan meddela att anropet debiterades.

Rekommenderad modell: suno-v6. suno-v6, suno-v6-wild och suno-v6-mini är tillgängliga.

Kinesisk utdata: innehåller begärans innehåll (originalTags/lyrics/user_guidance) kinesiska och ingen språkangivelse finns, lägger tjänsten automatiskt till （请用中文描述） efter original_tags och kompletterar med user_guidance=语言：简体中文；乐器名也用中文, för att öka träffsäkerheten för kinesiska stilbeskrivningar. De värden som faktiskt skickas returneras i appliedOriginalTags och appliedUserGuidance i svaret. Om innehållet du skickar redan anger ett språk (till exempel "beskriv på förenklad kinesiska") ändrar tjänsten ingenting.

Autentisering

Begäransparametrar

Exempelbegäran

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]\nNatten faller utanför fönstret\n[Chorus]\nVi går mot ljuset",
    "user_guidance": "lägg till suona och erhu, manlig sång, snabbare tempo",
    "instrumental": false
  }'

Svar

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

upsampledStyle är den fullständiga stilbeskrivning som ska skrivas tillbaka i Style-fältet.