API voor stijlversterking
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.
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