API de îmbunătățire a stilului

Actualizat pe 2026-09-18 · echipa Suno-API

Descrierea endpoint-ului

Îmbunătățirea stilului extinde o etichetă de stil scurtă într-o descriere mai completă și mai potrivită pentru generarea Suno și poate genera și un pasaj de stil din versuri complete.

Endpoint: POST /api/music/boost-style

Facturare: Gratuit în limita cotei (cel mult 10 apeluri pe minut și 300 pe zi per utilizator); peste cota gratuită se percepe 0,1 ¥ per apel.

Detectarea depășirii: când cota gratuită este depășită, cererea rulează totuși normal, iar anteturile răspunsului conțin X-Suno-Helper-Free: false și X-Suno-Helper-Over-Limit: minute (sau day), astfel încât clientul poate anunța că acest apel a fost facturat.

Model recomandat: suno-v6. Sunt disponibile suno-v6, suno-v6-wild și suno-v6-mini.

Ieșire în chineză: când conținutul cererii (originalTags/lyrics/user_guidance) conține chineză și nu declară limba, serviciul adaugă automat （请用中文描述） după original_tags și completează user_guidance=语言：简体中文；乐器名也用中文, pentru a crește rata de potrivire a descrierilor de stil în chineză. Valorile trimise efectiv sunt returnate în appliedOriginalTags și appliedUserGuidance din răspuns. Dacă conținutul trimis indică deja o limbă (de exemplu „descrie în chineză simplificată"), serviciul nu modifică nimic.

Autentificare

Parametrii cererii

Exemplu de cerere

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]\nNoaptea coboară dincolo de fereastră\n[Chorus]\nMergem spre lumină",
    "user_guidance": "adaugă suona și erhu, voce masculină, tempo mai rapid",
    "instrumental": false
  }'

Răspuns

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

upsampledStyle este descrierea completă a stilului care trebuie scrisă înapoi în câmpul Style.