--- title: Usa Suno in WorkBuddy tramite RunAPI — Guida MCP Musica | RunAPI description: Genera brani con Suno da v4 a v5.5 in WorkBuddy tramite l'MCP server RunAPI. Una chiave, modalità vocali, polling asincrono gestito dall'agente del workbench. url: https://runapi.ai/it/workbuddy-suno.md canonical: https://runapi.ai/it/workbuddy-suno locale: it site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-suno zh-CN: https://runapi.ai/zh-CN/workbuddy-suno es: https://runapi.ai/es/workbuddy-suno ja: https://runapi.ai/ja/workbuddy-suno de: https://runapi.ai/de/workbuddy-suno fr: https://runapi.ai/fr/workbuddy-suno pt-BR: https://runapi.ai/pt-BR/workbuddy-suno ko: https://runapi.ai/ko/workbuddy-suno it: https://runapi.ai/it/workbuddy-suno nl: https://runapi.ai/nl/workbuddy-suno pl: https://runapi.ai/pl/workbuddy-suno tr: https://runapi.ai/tr/workbuddy-suno zh-TW: https://runapi.ai/zh-TW/workbuddy-suno zh-HK: https://runapi.ai/zh-HK/workbuddy-suno ar: https://runapi.ai/ar/workbuddy-suno x-default: https://runapi.ai/workbuddy-suno model: suno --- > HTML version: https://runapi.ai/it/workbuddy-suno > Site index for agents: https://runapi.ai/llms.txt # 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. - [Ottieni API Key](https://runapi.ai/it/login) - [Leggi la documentazione API](https://runapi.ai/it/docs/guides) un MCP server · brani completi da testo · polling asincrono gestito ### Prompt ```text 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. ``` ### Configurazione MCP ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### Risposta ```json { "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 1. **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 ` 2. **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` 3. **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 ### Come scrivo prompt migliori per Suno per ottenere il genere e lo stile desiderati? 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. ### Quale versione di Suno dovrei usare -- v4, v5 o v5.5? 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. ### Devo eseguire il polling del task manualmente in WorkBuddy? 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. ### RunAPI fornisce un'API ufficiale di Suno? 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. ### Posso controllare il genere della voce e il peso dello stile? 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. - [Guida alla configurazione di WorkBuddy →](https://runapi.ai/it/workbuddy.md) - Non ancora connesso? Inizia con la guida alla configurazione MCP di RunAPI per WorkBuddy. - [Suno su RunAPI →](https://runapi.ai/it/models/suno.md) - Scopri tutte le versioni Suno, i prezzi e gli endpoint disponibili. ## 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. [Sfoglia i modelli →](https://runapi.ai/it/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/it/.md) ### Prodotto - [Catalogo dei modelli](https://runapi.ai/it/models.md) - [Prezzi](https://runapi.ai/it/pricing.md) - [Fornitori](https://runapi.ai/it/models#all-models) ### Sviluppatori - [Documentazione](https://runapi.ai/it/docs/guides) - [SDK](https://runapi.ai/it/sdk.md) - [CLI](https://runapi.ai/it/cli.md) - [MCP Server](https://runapi.ai/it/mcp.md) - [x402](https://runapi.ai/it/x402.md) ### Guide - [Claude Code vs Cursor](https://runapi.ai/it/claude-code-vs-cursor.md) - [Configurazione Cursor API](https://runapi.ai/it/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/it/openrouter-alternative.md) ### Azienda - [Enterprise](https://runapi.ai/it/contact.md) - [Contatti](https://runapi.ai/it/contact.md) ### Legale - [Termini](https://runapi.ai/it/terms.md) - [Privacy](https://runapi.ai/it/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "it", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/it", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/it/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/it", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/iticon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "SoftwareApplication", "name": "RunAPI Suno per WorkBuddy", "applicationCategory": "DeveloperApplication", "description": "Genera brani con Suno da v4 a v5.5 in WorkBuddy tramite l'MCP server RunAPI. Una chiave, modalità vocali, polling asincrono gestito dall'agente del workbench.", "url": "https://runapi.ai/it/workbuddy-suno" }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Come scrivo prompt migliori per Suno per ottenere il genere e lo stile desiderati?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Quale versione di Suno dovrei usare -- v4, v5 o v5.5?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Devo eseguire il polling del task manualmente in WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "RunAPI fornisce un'API ufficiale di Suno?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Posso controllare il genere della voce e il peso dello stile?", "acceptedAnswer": { "@type": "Answer", "text": "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." } } ] }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "HowTo", "name": "Come usare Suno in WorkBuddy tramite RunAPI", "description": "Aggiungi RunAPI come MCP server in WorkBuddy, descrivi il brano all'agente del workbench e lascia che esegua il task Suno asincrono e restituisca l'URL audio finito.", "step": [ { "@type": "HowToStep", "position": 1, "name": "Aggiungi RunAPI come server MCP", "text": "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.", "url": "https://runapi.ai/it/workbuddy-suno#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Descrivi il brano all'agente", "text": "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.", "url": "https://runapi.ai/it/workbuddy-suno#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Lascia che l'agente esegua il polling e recuperi l'audio", "text": "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.", "url": "https://runapi.ai/it/workbuddy-suno#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://runapi.ai/it" }, { "@type": "ListItem", "position": 2, "name": "RunAPI Suno per WorkBuddy", "item": "https://runapi.ai/it/workbuddy-suno" } ] } ] ```