Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.
Usa Suno in WorkBuddy.
Suno genera brani completi — voci, strumenti e missaggio — da un prompt testuale o da testi precisi. Le versioni dalla v4 alla v5.5 sono disponibili tramite RunAPI, che fornisce accesso API poiché Suno non ha un'API pubblica ufficiale. Aggiungi RunAPI come MCP server una volta sola, e l'agente WorkBuddy gestisce il task asincrono e restituisce l'URL audio del brano finito.
Using the runapi MCP server, generate a song with Suno.
Requirements:
- Call the Suno text_to_music tool exposed by the runapi MCP server.
- Set model to "suno-v5.5".
- Set vocal_mode to "auto_lyrics" so the lyrics are written from my brief.
- Prompt: an upbeat indie pop track about coding late at night,
warm synths and acoustic guitar, female vocals.
- The task is async — keep polling until the status is "completed",
then give me the audio URL.
{
"mcp_servers": {
"runapi": {
"url": "https://runapi.ai/mcp",
"transport": "streamable_http",
"headers": {
"Authorization": "Bearer $RUNAPI_API_KEY"
}
}
}
}
{
"task_id": "tsk_abc123",
"status": "completed",
"model": "suno-v5.5",
"output": {
"audio_url": "https://media.runapi.ai/outputs/tsk_abc123.mp3",
"title": "Midnight Compile",
"duration_seconds": 187
}
}
Usa Suno in WorkBuddy in tre passaggi
Aggiungi RunAPI come server MCP
Imposta RUNAPI_API_KEY nell'ambiente che avvia WorkBuddy, poi registra un MCP server con nome runapi puntando a https://runapi.ai/mcp tramite HTTP streamable. Suno appare come tool musicale richiamabile insieme a tutti gli altri modelli RunAPI — nessun servizio musicale separato da configurare.
export RUNAPI_API_KEY=runapi_xxx
# MCP server: runapi → https://runapi.ai/mcp
Descrivi il brano all'agente
Di' a WorkBuddy cosa vuoi in linguaggio naturale e specifica la modalità. Usa auto_lyrics con un prompt per testi scritti dall'IA, exact_lyrics con testi/stile/titolo per le tue parole, o instrumental con stile/titolo per nessuna voce. L'agente mappa il tuo brief sulla chiamata al tool Suno.
vocal_mode: auto_lyrics
Lascia che l'agente esegua il polling e recuperi l'audio
La generazione del brano è asincrona e richiede da 30 secondi a diversi minuti a seconda della versione. L'agente del workbench interroga il task fino a quando lo stato non è completed, poi pubblica l'URL audio di output nella conversazione — non devi mai gestire un task_id tu stesso.
"status": "completed"
Parametri di 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 (l'AI scrive i testi dal prompt), exact_lyrics (fornisci testi/stile/titolo) o instrumental (nessuna voce, richiede stile/titolo). |
prompt |
string |
Brief del brano per la modalità auto_lyrics. Descrivi genere, umore, ritmo e argomento. Non consentito nelle modalità exact_lyrics e instrumental. |
lyrics |
string |
Testi esatti da cantare. Obbligatorio per la modalità exact_lyrics. Non consentito nelle modalità auto_lyrics e instrumental. |
style |
string |
Descrizione dello stile musicale, es. lo-fi hip hop, synthwave anni '80. Obbligatorio per le modalità exact_lyrics e instrumental. |
vocal_gender |
string |
Facoltativo. male o female. |
negative_tags |
string |
Facoltativo. Stili da evitare, es. heavy metal, urla. |
Cos'è Suno su WorkBuddy?
Suno è un'IA text-to-music che genera brani completi — voci, strumenti e missaggio — da un prompt testuale o dai tuoi testi. Funziona come un blocco appunti per la composizione: descrivi genere, mood e tempo e ottieni una traccia completa. WorkBuddy lo raggiunge tramite l'MCP server RunAPI poiché Suno non ha un'API pubblica ufficiale, fornendo all'agente del workbench accesso programmatico alle versioni dalla v4 alla v5.5 con la stessa chiave usata per chat e immagini.
Casi d'uso di Suno
Musica di sottofondo per YouTube e social media
Chiedi all'agente del workbench tracce di sottofondo originali descrivendo mood e genere. Nessuna spesa di licenza, nessun problema di royalty — la traccia viene generata su misura per il tuo contenuto e l'URL ritorna in WorkBuddy.
Ascoltare i testi come canzone completa
Chi scrive testi può incollarli in WorkBuddy e richiedere la modalità exact_lyrics con una descrizione dello stile, ascoltandoli eseguiti come brano completo — una demo di produzione prima del tempo in studio.
Sigle di apertura e chiusura per podcast
Crea musica strumentale di intro e outro adatta al tono di un podcast specificando genere, mood e durata. Chiedi all'agente di generare diverse variazioni in un'unica conversazione e scegli quella migliore.
Domande su Suno + WorkBuddy
Sii specifico su genere, mood, tempo e strumentazione nel brief a WorkBuddy. Ad esempio, "indie pop vivace a 120 BPM con chitarra acustica e synth caldi" funziona meglio di "canzone allegra". Chiedi all'agente di passare negative_tags per escludere elementi indesiderati come heavy metal o urla.
suno-v5.5 è l'ultima versione e produce output di qualità più elevata con maggiore chiarezza vocale e missaggio migliore. suno-v4 e suno-v4.5 sono più economici e veloci per le iterazioni in bozza. Tutte le versioni sono dietro lo stesso MCP server runapi, quindi cambiare versione significa solo nominarne una diversa nel prompt.
No. I task Suno sono asincroni, ma l'agente del workbench gestisce l'intero ciclo di vita — crea il task tramite il tool MCP, interroga finché lo stato non è completed e pubblica l'URL audio nella conversazione. Tu descrivi solo il brano e aspetti.
Suno non offre un'API pubblica. RunAPI fornisce accesso programmatico a Suno dalla v4 alla v5.5 tramite la stessa chiave API e il ciclo di vita dei task usati per tutti gli altri modelli RunAPI. Non è necessario un account Suno né credenziali separate.
Sì. Chiedi vocal_gender male o female e usa negative_tags per escludere stili indesiderati. Per un controllo più preciso, crea una persona tramite l'endpoint personas e passa il persona_id restituito con persona_type impostato su voice o style.
Configurazione generale di WorkBuddy
Non ancora connesso? Inizia con la guida alla configurazione MCP di RunAPI per WorkBuddy.
Guida alla configurazione di WorkBuddy →Catalogo modelli Suno
Scopri tutte le versioni Suno, i prezzi e gli endpoint disponibili.
Suno su RunAPI →Prova Suno in WorkBuddy oggi stesso.
Ottieni una chiave RunAPI gratuita, aggiungi l'MCP server a WorkBuddy e descrivi un brano — l'agente del workbench restituisce una traccia completa con voci, strumenti e missaggio.