Introduzione
Suno v6 su SpicyAPI è un task text-to-music che restituisce per ogni richiesta due versioni complete di un brano, ciascuna un MP3 intero con voce e base. Descrivi lo stile in prompt e, se li hai, metti le parole da cantare in lyrics. Secondo Suno, v6 è il suo modello affidabile e preciso, e nei nostri test ha cantato un testo parola per parola, in ordine. Un prezzo fisso copre l’intera richiesta.
Caratteristiche principali
Due take ogni volta
Ogni richiesta restituisce due versioni complete del brano. Non sono estratti l’una dell’altra: possono differire per arrangiamento e per durata, così puoi tenere quella che ti piace. Il prezzo fisso copre entrambe.
Il tuo testo, cantato com’è scritto
Un testo di 11 righe è tornato cantato riga per riga nell’ordine in cui l’avevamo scritto. I tag di sezione come [Verse] e [Chorus] hanno dato forma alla struttura senza essere cantati, e il ritornello non è stato ripetuto se non lo ripeteva il testo.
Tre modi di gestire le parole
Porta il tuo testo, lascia che lo scriva il modello a partire da prompt (generate_lyrics è attivo di default) oppure attiva instrumental per niente voce. I controlli di dettaglio come title, vocal_gender, style_weight, weirdness, variety e le persona valgono quando porti il tuo testo o scegli lo strumentale.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Il brief di stile. Con testo tuo o con instrumental attivo è solo lo stile: genere, tempo, strumenti, voce, atmosfera, fino a 1.000 caratteri. almeno 1 caratteri · al massimo 3000 caratteri |
lyrics | No | Le parole da cantare, fino a 5.000 caratteri, una riga per rigo. almeno 1 caratteri · al massimo 5000 caratteri |
generate_lyrics | No | Attivo di default: quando lyrics è vuoto e instrumental è disattivato, il modello scrive il testo a partire da prompt. Il testo che fornisci non viene mai riscritto. Predefinito: |
instrumental | No | Attivalo per un brano senza voce. Allora prompt descrive lo stile (fino a 1.000 caratteri) e lyrics non serve. Predefinito: |
title | No | Titolo del brano, fino a 80 caratteri. Vale con testo tuo o con instrumental attivo; con testo generato il titolo lo sceglie il modello. almeno 1 caratteri · al massimo 80 caratteri |
negative_prompt | No | Stili, suoni o atmosfere da tenere fuori dal brano, come breve elenco separato da virgole, per esempio “harsh distortion, spoken word”. Facoltativo. almeno 1 caratteri · al massimo 500 caratteri |
vocal_gender | No | Orienta la voce principale verso il femminile o il maschile. È una preferenza, non una garanzia, e non abbiamo testato quanto spesso venga rispettata. |
style_weight | No | Quanto rigorosamente il brano segue il tuo brief di stile, da 0 a 1 a passi di 0,01. Vale solo con testo tuo o con instrumental attivo; altrove restituisce un errore chiaro. |
weirdness | No | Quanto il brano può allontanarsi dal prevedibile, da 0 (convenzionale) a 1 (azzardato), a passi di 0,01. Vale solo con testo tuo o con instrumental attivo. |
audio_weight | No | Quanto l’audio in ingresso influenza il risultato, da 0 a 1 a passi di 0,01. Suno non lo supporta per i brani senza voce. |
variety | No | Quanto il modello varia il tuo prompt di stile, come numero intero da 0 (disattivato: i tuoi tag di stile vengono usati esattamente come scritti) a 4 (massimo). Predefinito 1. |
persona_id | No | L’ID di una persona o voce Suno salvata che canta o suona il brano. Facoltativo. almeno 1 caratteri · al massimo 200 caratteri |
persona_model | No | Dice al modello che cos’è |
image_urls | No | Fino a 5 immagini di atmosfera (JPEG, PNG, WebP o BMP, ciascuna fino a 10 MB) a cui il modello si ispira per il carattere del brano. al massimo 5 elementi |
reference_video_urls | No | Un video di riferimento (MP4, MOV o WebM, fino a 100 MB e 241 secondi) attorno a cui costruire il brano, per esempio per musicarlo. al massimo 1 elementi |
reference_audio_urls | No | Un file audio di riferimento (da 6 secondi a 30 minuti, fino a 500 MB) che ispira il brano. Solo con testo generato: nessun testo, instrumental disattivato, |
Prezzi
$0.072 / richiesta
Un prezzo fisso per richiesta, che comprende entrambe le versioni del brano, qualunque sia la durata.
Casi d’uso
Canzoni che hai già scritto
Poesie, brindisi, jingle e storie in musica: tieni il testo, scegli genere e voce e confronta due versioni. I brani sono durati da circa un minuto e mezzo per un testo breve a oltre due minuti per uno completo.
Musica che segue un’immagine o una clip
Con il testo generato puoi inviare fino a 5 immagini di atmosfera, un video di riferimento o un audio di riferimento, e il modello scrive un brano attorno a loro. Per un sottofondo senza parole, attiva instrumental.
Consigli avanzati
Descrivi il suono, non l’artista
Scrivi genere, tempo in bpm, due o tre strumenti e il tipo di voce: “soft neo-soul ballad, 78 bpm, warm female lead vocal, Rhodes piano”. I prompt che citano artisti reali vengono rifiutati, quindi descrivi il suono.
Tagga le sezioni
Metti [Intro], [Verse], [Chorus], [Bridge] e [Outro] su righe a sé e ripeti il testo del ritornello dove vuoi che torni. Più righe significano un brano più lungo; non c’è un’impostazione di durata.
Sappi che cosa ferma il filtro
Suno rifiuta in pochi secondi i testi e le descrizioni più forti e non li addebita. Testi più leggeri e linguaggio forte vengono cantati, quindi tieni ciò che scrivi da questo lato della linea.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "suno/v6/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
