Qual è la differenza tra auto_lyrics, exact_lyrics e instrumental?

auto_lyrics genera il testo dalla tua descrizione — descrivi il brano e Suno scrive le parole. exact_lyrics usa il testo che fornisci letteralmente, e richiede i campi style e title. instrumental produce un brano senza voce, usando solo style e title.

Quale versione di Suno dovrei usare?

suno-v5.5 è l'ultima versione e produce l'output di qualità più alta con maggiore chiarezza vocale e mixaggio. suno-v4 e suno-v4.5 sono più economici e veloci per le iterazioni di bozza. Tutte le versioni usano lo stesso endpoint text_to_music e gli stessi parametri.

Quanto tempo richiede la generazione con Suno?

Il tempo di generazione varia in base alla versione e alla durata del brano. Il tempo tipico è da 30 secondi a 2 minuti. L'API restituisce immediatamente un task_id — esegui il polling dell'endpoint di stato o imposta un callback_url per evitare di bloccare il tuo agente.

RunAPI fornisce una API ufficiale Suno?

Suno non offre una API pubblica. RunAPI fornisce accesso programmatico a Suno dalla v4 alla v5.5 tramite la stessa API key e lo stesso ciclo di vita dei task usati per tutti gli altri modelli RunAPI. Non è necessario un account Suno o credenziali separate.

Posso controllare il genere vocale e il peso dello stile?

Sì. Imposta vocal_gender su male o female. Usa negative_tags per escludere stili indesiderati. Per un controllo più fine, crea una persona tramite l'endpoint generate_persona e passa il persona_id restituito con persona_type impostato su voice o style.

OPENCLAW + SUNO

Usa Suno in OpenClaw.

Suno genera brani completi — voce, strumenti e mixaggio — da un prompt testuale o testo esatto. Le versioni dalla v4 alla v5.5 sono disponibili tramite RunAPI, che fornisce accesso API poiché Suno non ha una API pubblica ufficiale. Gli agenti OpenClaw la chiamano con la stessa RUNAPI_API_KEY usata per la chat.

Ottieni API Key Leggi la documentazione API

una API key · endpoint text to music · polling asincrono dei task

Usa RunAPI per generare un brano con Suno.

Requisiti:
- Leggi la API key da RUNAPI_API_KEY.
- Chiama POST https://runapi.ai/api/v1/suno/text_to_music
- Imposta model su "suno-v5.5".
- Imposta vocal_mode su "auto_lyrics" per testi generati dall'AI da un prompt.
- Imposta prompt per descrivere il brano che vuoi.
- Il task è asincrono. Esegui il polling del task_id restituito finché lo status non è "completed".
- Al termine, leggi l'URL audio dall'output della risposta.

curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v5.5",
    "vocal_mode": "auto_lyrics",
    "prompt": "An upbeat indie pop track about coding late at night, warm synths and acoustic guitar",
    "vocal_gender": "female"
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "suno-v5.5"
}

Copia il comando curl per testare suno

COME FUNZIONA

Usa Suno in OpenClaw in tre passaggi

Configura RunAPI

Imposta RUNAPI_API_KEY nel tuo ambiente. Se hai già configurato RunAPI in OpenClaw per la chat, la stessa key funziona per la generazione musicale con Suno — nessuna configurazione aggiuntiva del provider necessaria.

export RUNAPI_API_KEY=runapi_xxx

Chiama text_to_music

Invia una POST all'endpoint text_to_music con il modello e vocal_mode. Usa auto_lyrics con un prompt per testi scritti dall'AI, exact_lyrics con testo/stile/titolo per le tue parole, o instrumental con stile/titolo per brani senza voce.

POST /api/v1/suno/text_to_music

Ottieni il risultato

L'endpoint restituisce immediatamente un task_id. La generazione del brano richiede da 30 secondi a diversi minuti a seconda della versione. Esegui il polling dell'endpoint di stato del task finché lo stato non cambia in completed, poi leggi l'URL audio di output.

GET /api/v1/suno/text_to_music/tsk_abc123

PARAMETRI

Parametri API Suno text_to_music

Parametro	Tipo	Descrizione
`model`	`string`	Obbligatorio. suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5 o suno-v5.5.
`vocal_mode`	`string`	Obbligatorio. auto_lyrics (AI scrive il testo dal prompt), exact_lyrics (fornisci testo/stile/titolo) o instrumental (senza voce, richiede stile/titolo).
`prompt`	`string`	Descrizione del brano per la modalità auto_lyrics. Descrivi genere, atmosfera, ritmo e tema. Non consentito nelle modalità exact_lyrics e instrumental.
`lyrics`	`string`	Testo esatto da cantare. Obbligatorio per la modalità exact_lyrics. Non consentito nelle modalità auto_lyrics e instrumental.
`style`	`string`	Descrizione dello stile musicale, ad es. lo-fi hip hop, synthwave anni '80. Obbligatorio per le modalità exact_lyrics e instrumental.
`title`	`string`	Titolo del brano. Obbligatorio per le modalità exact_lyrics e instrumental.
`vocal_gender`	`string`	Facoltativo. male o female.
`negative_tags`	`string`	Facoltativo. Stili da evitare, ad es. heavy metal, screaming.
`duration_seconds`	`integer`	Facoltativo. Durata target in secondi.
`persona_id`	`string`	Facoltativo. ID persona per profili vocali o di stile personalizzati.
`persona_type`	`string`	Facoltativo. style o voice. Seleziona la categoria della persona.
`callback_url`	`string`	Facoltativo. URL webhook che riceve una POST quando il task è completato.

Cos'è Suno su OpenClaw?

Suno è un'IA testo-a-musica che genera canzoni complete -- voce, strumenti e mixaggio -- da un prompt testuale o dalle tue stesse parole. Funziona come un blocco note per la composizione dove descrivi il genere, l'umore e il tempo, e ricevi una traccia completa. Gli agenti OpenClaw lo chiamano tramite RunAPI poiché Suno non ha API pubblica ufficiale, dandoti accesso programmatico alle versioni da v4 a v5.5.

Casi d'uso di Suno

Musica di sottofondo per YouTube e i social media

Generare tracce di sottofondo originali per i video descrivendo l'umore e il genere in un prompt. Nessuna tariffa di licenza, nessun problema di royalty -- la traccia viene generata fresca per il tuo contenuto.

Sentire le parole come una canzone completa

I parolieri possono incollare le loro parole nella modalità exact_lyrics con una descrizione di stile e sentirle eseguite come una canzone completa, trasformando le parole scritte in una demo di produzione prima del tempo in studio.

Jingle di intro e outro per podcast

Creare musica strumentale di intro e outro adatta al tono di un podcast specificando genere, umore e durata. Generare diverse variazioni e scegliere quella più adatta.

FAQ

Domande su Suno + OpenClaw

Configurazione generale di OpenClaw

Non ancora configurato? Inizia con la guida di configurazione RunAPI per OpenClaw.

Guida di configurazione di OpenClaw →

Catalogo modelli Suno

Vedi tutte le versioni di Suno, i prezzi e gli endpoint disponibili.

Suno su RunAPI →

Prova Suno in OpenClaw oggi.

Ottieni una API key RunAPI gratuita, incolla il prompt in OpenClaw e genera brani completi con voce, strumenti e mixaggio da una descrizione testuale.

Sfoglia i modelli →