API voor stijlversterking

Bijgewerkt op 2026-09-18 · Suno-API-team

Beschrijving van het endpoint

Stijlversterking breidt een korte stiltag uit tot een vollediger stijlomschrijving die beter past bij Suno-generatie, en kan ook een stijlpassage genereren uit een volledige songtekst.

Endpoint: POST /api/music/boost-style

Facturering: Gratis binnen het quotum (maximaal 10 aanroepen per minuut en 300 per dag per gebruiker); boven het gratis quotum kost het 0,1 ¥ per aanroep.

Overschrijding herkennen: bij overschrijding van het gratis quotum loopt het verzoek gewoon door, en de antwoordheaders bevatten X-Suno-Helper-Free: false en X-Suno-Helper-Over-Limit: minute (of day), zodat de client kan melden dat deze aanroep is gefactureerd.

Aanbevolen model: suno-v6. Beschikbaar zijn suno-v6, suno-v6-wild en suno-v6-mini.

Chinese uitvoer: bevat de verzoekinhoud (originalTags/lyrics/user_guidance) Chinees en is er geen taal aangegeven, dan voegt de dienst automatisch (请用中文描述) toe na original_tags en vult user_guidance=语言:简体中文;乐器名也用中文 aan, om de trefkans van Chinese stijlbeschrijvingen te verhogen. De waarden die daadwerkelijk worden verzonden, komen terug in appliedOriginalTags en appliedUserGuidance in het antwoord. Staat de taal al in de inhoud die u stuurt (bijvoorbeeld "beschrijf in vereenvoudigd Chinees"), dan wijzigt de dienst niets.

Authenticatie

Parameter Type Verplicht Opmerkingen
Authorization string ja Bearer YOUR_API_KEY
Content-Type string ja application/json

Verzoekparameters

Parameter Type Verplicht Standaard Opmerkingen
model string ja - Modelnaam voor klanten: suno-v6, suno-v6-wild of suno-v6-mini
originalTags string nee - Oorspronkelijke stiltags
original_tags string nee - Compatibel alias van originalTags
style string nee - Oorspronkelijke stiltags; alternatief voor originalTags
instrumental boolean nee false Of er richting instrumentaal moet worden versterkt
lyrics string nee - Volledige songtekst; eenmaal meegegeven wordt daaruit een stijlbeschrijving gegenereerd
user_guidance string nee - Verzoek in natuurlijke taal van de gebruiker, bijvoorbeeld "voeg suona en erhu toe, mannenstem, sneller tempo"; het platform heeft een veld met dezelfde naam en geeft het ongewijzigd door

Voorbeeldverzoek

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]\nDe nacht valt achter het raam\n[Chorus]\nWij lopen naar het licht",
    "user_guidance": "voeg suona en erhu toe, mannenstem, sneller tempo",
    "instrumental": false
  }'

Antwoord

{
  "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 de volledige stijlbeschrijving die teruggeschreven moet worden in het Style-veld.

VolgendeAPI voor promptsuggesties

Een API-sleutel aanvragen

Maak na je registratie een API-sleutel aan in de console. Elke generatie kost ¥0,6 en levert 2 nummers op, downloads zijn onbeperkt en een telefoonnummer is niet nodig.

API-sleutel ophalen Terug naar overzicht