--- title: Use Suno no WorkBuddy via RunAPI — Guia de Música MCP | RunAPI description: Gere músicas com Suno v4 a v5.5 no WorkBuddy através do servidor MCP do RunAPI. Uma chave, modos vocais, polling assíncrono gerenciado pelo agente do workbench. url: https://runapi.ai/pt-BR/workbuddy-suno.md canonical: https://runapi.ai/pt-BR/workbuddy-suno locale: pt-BR 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/pt-BR/workbuddy-suno > Site index for agents: https://runapi.ai/llms.txt # Use Suno no WorkBuddy. O Suno gera músicas completas — vocais, instrumentos e mixagem — a partir de um prompt de texto ou letras exatas. As versões v4 a v5.5 estão disponíveis pelo RunAPI, que fornece acesso via API já que o Suno não possui API pública oficial. Adicione o RunAPI como servidor MCP uma única vez e o agente WorkBuddy gerencia a tarefa assíncrona e retorna a URL do áudio finalizado. - [Obter API Key](https://runapi.ai/pt-BR/login) - [Ler a documentação](https://runapi.ai/pt-BR/docs/guides) um servidor MCP · músicas completas a partir de texto · polling assíncrono gerenciado ### 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. ``` ### Configuração MCP ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### Resposta ```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 } } ``` ## Use o Suno no WorkBuddy em três etapas 1. **Adicione o RunAPI como servidor MCP** - Defina RUNAPI_API_KEY no ambiente que inicializa o WorkBuddy e registre um servidor MCP chamado runapi apontando para https://runapi.ai/mcp via HTTP streamable. O Suno aparece como uma ferramenta de música disponível ao lado de todos os outros modelos do RunAPI — nenhum serviço de música separado para configurar. `export RUNAPI_API_KEY=runapi_xxx # MCP server: runapi → https://runapi.ai/mcp ` 2. **Descreva a música ao agente** - Diga ao WorkBuddy o que você quer em linguagem natural e informe o modo. Use auto_lyrics com um prompt para letras escritas por IA, exact_lyrics com lyrics/style/title para suas próprias palavras, ou instrumental com style/title para sem vocais. O agente mapeia seu briefing para a chamada da ferramenta Suno. `vocal_mode: auto_lyrics` 3. **Deixe o agente fazer o polling e coletar o áudio** - A geração de músicas é assíncrona e leva de 30 segundos a vários minutos dependendo da versão. O agente do workbench faz polling da tarefa até que o status seja completed e então posta a URL do áudio de saída na conversa — você nunca precisa lidar com um task_id diretamente. `"status": "completed"` ## Parâmetros de text_to_music do Suno | Parâmetro | Tipo | Descrição | | --- | --- | --- | | `model` | `string` | Obrigatório. suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5 ou suno-v5.5. | | `vocal_mode` | `string` | Obrigatório. auto_lyrics (a IA escreve a letra a partir do prompt), exact_lyrics (você fornece lyrics/style/title) ou instrumental (sem vocais, requer style/title). | | `prompt` | `string` | Briefing da música para o modo auto_lyrics. Descreva gênero, mood, tempo e tema. Proibido nos modos exact_lyrics e instrumental. | | `lyrics` | `string` | Letra exata para cantar. Obrigatório para o modo exact_lyrics. Proibido nos modos auto_lyrics e instrumental. | | `style` | `string` | Descrição do estilo musical, ex.: lo-fi hip hop, synthwave dos anos 80. Obrigatório para os modos exact_lyrics e instrumental. | | `vocal_gender` | `string` | Opcional. male ou female. | | `negative_tags` | `string` | Opcional. Estilos a evitar, ex.: heavy metal, screaming. | ## O que é o Suno no WorkBuddy? O Suno é uma IA de texto para música que gera canções completas — vocais, instrumentos e mixagem — a partir de um prompt de texto ou de suas próprias letras. Funciona como um rascunho de composição onde você descreve o gênero, o mood e o tempo e recebe uma faixa completa. O WorkBuddy o acessa pelo servidor MCP do RunAPI, já que o Suno não tem API pública oficial, dando ao agente do workbench acesso programático às versões v4 a v5.5 com a mesma chave usada para chat e imagens. ## Casos de uso do Suno - **Música de fundo para YouTube e redes sociais** - Peça ao agente do workbench trilhas de fundo originais descrevendo o mood e o gênero. Sem taxas de licenciamento, sem questões de royalties — a faixa é gerada especialmente para seu conteúdo e a URL retorna direto no WorkBuddy. - **Ouvir letras como uma música completa** - Letristas podem colar suas palavras no WorkBuddy e pedir o modo exact_lyrics com uma descrição de estilo, ouvindo-as interpretadas como uma música completa — uma demo de produção antes do tempo de estúdio. - **Vinhetas de abertura e encerramento para podcasts** - Crie músicas instrumentais de introdução e encerramento combinando com o tom de um podcast especificando gênero, mood e duração. Peça ao agente para gerar várias variações em uma única conversa e escolha a melhor. ## Perguntas sobre Suno + WorkBuddy ### Como escrever prompts melhores para o Suno e obter o gênero e estilo que desejo? Seja específico sobre gênero, mood, tempo e instrumentação no seu briefing para o WorkBuddy. Por exemplo, "indie pop animado a 120 BPM com violão acústico e sintetizadores quentes" funciona melhor do que "música feliz." Peça ao agente para passar negative_tags para excluir elementos indesejados, como heavy metal ou gritaria. ### Qual versão do Suno devo usar — v4, v5 ou v5.5? suno-v5.5 é o mais recente e produz a saída de maior qualidade com melhor clareza vocal e mixagem. suno-v4 e suno-v4.5 são mais baratos e rápidos para iterações de rascunho. Todas as versões ficam atrás do mesmo servidor MCP runapi, então trocar é apenas nomear uma versão diferente no seu prompt. ### Preciso fazer o polling da tarefa eu mesmo no WorkBuddy? Não. As tarefas do Suno são assíncronas, mas o agente do workbench gerencia o ciclo de vida — cria a tarefa pela ferramenta MCP, faz polling até o status ser completed e posta a URL do áudio de volta na conversa. Você só descreve a música e aguarda. ### O RunAPI oferece uma API oficial do Suno? O Suno não oferece uma API pública. O RunAPI fornece acesso programático ao Suno v4 até v5.5 com a mesma chave de API e ciclo de vida de tarefas usados para todos os outros modelos do RunAPI. Nenhuma conta Suno ou credenciais separadas são necessárias. ### Posso controlar o gênero da voz e o peso do estilo? Sim. Peça vocal_gender male ou female e use negative_tags para excluir estilos indesejados. Para um controle mais fino, crie uma persona pelo endpoint personas e passe o persona_id retornado com persona_type definido como voice ou style. - [Guia de configuração do WorkBuddy →](https://runapi.ai/pt-BR/workbuddy.md) - Ainda não conectado? Comece com o guia de configuração do RunAPI MCP para WorkBuddy. - [Suno no RunAPI →](https://runapi.ai/pt-BR/models/suno.md) - Veja todas as versões do Suno, preços e endpoints disponíveis. ## Experimente o Suno no WorkBuddy hoje. Obtenha uma chave RunAPI gratuita, adicione o servidor MCP ao WorkBuddy e descreva uma música — o agente do workbench retorna uma faixa completa com vocais, instrumentos e mixagem. [Explorar modelos →](https://runapi.ai/pt-BR/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/pt-BR/.md) ### Produto - [Catálogo de modelos](https://runapi.ai/pt-BR/models.md) - [Preços](https://runapi.ai/pt-BR/pricing.md) - [Provedores](https://runapi.ai/pt-BR/models#all-models) ### Desenvolvedores - [Documentação](https://runapi.ai/pt-BR/docs/guides) - [SDKs](https://runapi.ai/pt-BR/sdk.md) - [CLI](https://runapi.ai/pt-BR/cli.md) - [Servidor MCP](https://runapi.ai/pt-BR/mcp.md) - [x402](https://runapi.ai/pt-BR/x402.md) ### Guias - [Claude Code vs Cursor](https://runapi.ai/pt-BR/claude-code-vs-cursor.md) - [Configuração da API do Cursor](https://runapi.ai/pt-BR/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/pt-BR/openrouter-alternative.md) ### Empresa - [Enterprise](https://runapi.ai/pt-BR/contact.md) - [Contato](https://runapi.ai/pt-BR/contact.md) ### Legal - [Termos](https://runapi.ai/pt-BR/terms.md) - [Privacidade](https://runapi.ai/pt-BR/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/pt-BR/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/pt-BRicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "SoftwareApplication", "name": "RunAPI Suno para WorkBuddy", "applicationCategory": "DeveloperApplication", "description": "Gere músicas com Suno v4 a v5.5 no WorkBuddy através do servidor MCP do RunAPI. Uma chave, modos vocais, polling assíncrono gerenciado pelo agente do workbench.", "url": "https://runapi.ai/pt-BR/workbuddy-suno" }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Como escrever prompts melhores para o Suno e obter o gênero e estilo que desejo?", "acceptedAnswer": { "@type": "Answer", "text": "Seja específico sobre gênero, mood, tempo e instrumentação no seu briefing para o WorkBuddy. Por exemplo, \"indie pop animado a 120 BPM com violão acústico e sintetizadores quentes\" funciona melhor do que \"música feliz.\" Peça ao agente para passar negative_tags para excluir elementos indesejados, como heavy metal ou gritaria." } }, { "@type": "Question", "name": "Qual versão do Suno devo usar — v4, v5 ou v5.5?", "acceptedAnswer": { "@type": "Answer", "text": "suno-v5.5 é o mais recente e produz a saída de maior qualidade com melhor clareza vocal e mixagem. suno-v4 e suno-v4.5 são mais baratos e rápidos para iterações de rascunho. Todas as versões ficam atrás do mesmo servidor MCP runapi, então trocar é apenas nomear uma versão diferente no seu prompt." } }, { "@type": "Question", "name": "Preciso fazer o polling da tarefa eu mesmo no WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "Não. As tarefas do Suno são assíncronas, mas o agente do workbench gerencia o ciclo de vida — cria a tarefa pela ferramenta MCP, faz polling até o status ser completed e posta a URL do áudio de volta na conversa. Você só descreve a música e aguarda." } }, { "@type": "Question", "name": "O RunAPI oferece uma API oficial do Suno?", "acceptedAnswer": { "@type": "Answer", "text": "O Suno não oferece uma API pública. O RunAPI fornece acesso programático ao Suno v4 até v5.5 com a mesma chave de API e ciclo de vida de tarefas usados para todos os outros modelos do RunAPI. Nenhuma conta Suno ou credenciais separadas são necessárias." } }, { "@type": "Question", "name": "Posso controlar o gênero da voz e o peso do estilo?", "acceptedAnswer": { "@type": "Answer", "text": "Sim. Peça vocal_gender male ou female e use negative_tags para excluir estilos indesejados. Para um controle mais fino, crie uma persona pelo endpoint personas e passe o persona_id retornado com persona_type definido como voice ou style." } } ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "HowTo", "name": "Como usar o Suno no WorkBuddy via RunAPI", "description": "Adicione o RunAPI como servidor MCP no WorkBuddy, descreva a música ao agente do workbench e deixe-o executar a tarefa assíncrona do Suno e retornar a URL do áudio finalizado.", "step": [ { "@type": "HowToStep", "position": 1, "name": "Adicione o RunAPI como servidor MCP", "text": "Defina RUNAPI_API_KEY no ambiente que inicializa o WorkBuddy e registre um servidor MCP chamado runapi apontando para https://runapi.ai/mcp via HTTP streamable. O Suno aparece como uma ferramenta de música disponível ao lado de todos os outros modelos do RunAPI — nenhum serviço de música separado para configurar.", "url": "https://runapi.ai/pt-BR/workbuddy-suno#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Descreva a música ao agente", "text": "Diga ao WorkBuddy o que você quer em linguagem natural e informe o modo. Use auto_lyrics com um prompt para letras escritas por IA, exact_lyrics com lyrics/style/title para suas próprias palavras, ou instrumental com style/title para sem vocais. O agente mapeia seu briefing para a chamada da ferramenta Suno.", "url": "https://runapi.ai/pt-BR/workbuddy-suno#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Deixe o agente fazer o polling e coletar o áudio", "text": "A geração de músicas é assíncrona e leva de 30 segundos a vários minutos dependendo da versão. O agente do workbench faz polling da tarefa até que o status seja completed e então posta a URL do áudio de saída na conversa — você nunca precisa lidar com um task_id diretamente.", "url": "https://runapi.ai/pt-BR/workbuddy-suno#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Início", "item": "https://runapi.ai/pt-BR" }, { "@type": "ListItem", "position": 2, "name": "RunAPI Suno para WorkBuddy", "item": "https://runapi.ai/pt-BR/workbuddy-suno" } ] } ] ```