API di potenziamento dello stile

Aggiornato il 2026-09-18 · team Suno-API

Descrizione dell'endpoint

Il potenziamento dello stile espande un tag di stile breve in una descrizione più completa e più adatta alla generazione Suno, e può anche generare un passaggio di stile dal testo completo.

Endpoint: POST /api/music/boost-style

Fatturazione: Gratis entro la quota (al massimo 10 chiamate al minuto e 300 al giorno per utente); oltre la quota gratuita viene addebitato 0,1 ¥ per chiamata.

Rilevare il superamento: quando la quota gratuita viene superata la richiesta funziona comunque normalmente, e le intestazioni di risposta riportano X-Suno-Helper-Free: false e X-Suno-Helper-Over-Limit: minute (o day), così il client può segnalare che questa chiamata è stata addebitata.

Modello consigliato: suno-v6. Sono disponibili suno-v6, suno-v6-wild e suno-v6-mini.

Output in cinese: quando il contenuto della richiesta (originalTags/lyrics/user_guidance) contiene cinese e non dichiara la lingua, il servizio aggiunge automaticamente （请用中文描述） dopo original_tags e integra user_guidance=语言：简体中文；乐器名也用中文, per aumentare la probabilità di ottenere descrizioni di stile in cinese. I valori effettivamente inviati vengono restituiti in appliedOriginalTags e appliedUserGuidance nella risposta. Se il contenuto inviato indica già una lingua (ad esempio «descrivi in cinese semplificato»), il servizio non modifica nulla.

Autenticazione

Parametro	Tipo	Obbligatorio	Note
Authorization	string	sì	`Bearer YOUR_API_KEY`
Content-Type	string	sì	`application/json`

Parametri della richiesta

Parametro	Tipo	Obbligatorio	Predefinito	Note
model	string	sì	-	Nome del modello lato cliente: `suno-v6`, `suno-v6-wild` o `suno-v6-mini`
originalTags	string	no	-	Tag di stile originali
original_tags	string	no	-	Alias compatibile di `originalTags`
style	string	no	-	Tag di stile originali; alternativa a `originalTags`
instrumental	boolean	no	false	Se potenziare in direzione strumentale
lyrics	string	no	-	Testo completo; una volta inviato, la descrizione di stile viene generata dal suo contenuto
user_guidance	string	no	-	Richiesta in linguaggio naturale dell'utente, ad esempio «aggiungi suona ed erhu, voce maschile, tempo più veloce»; la piattaforma ha un campo con lo stesso nome e lo inoltra così com'è

Esempio di richiesta

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]\nLa notte cade oltre la finestra\n[Chorus]\nCamminiamo verso la luce",
    "user_guidance": "aggiungi suona ed erhu, voce maschile, tempo più veloce",
    "instrumental": false
  }'

Risposta

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

upsampledStyle è la descrizione di stile completa da riscrivere nel campo Style.

AvantiAPI di suggerimenti prompt

Ottenere una chiave API

Dopo la registrazione puoi creare una chiave API nella console. Ogni generazione costa 0,6 ¥ e restituisce 2 brani, i download sono illimitati e non serve un numero di telefono.

Ottieni chiave API Torna alla panoramica