Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.

WORKBUDDY + SUNO

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 Ler a documentação
um servidor MCP · músicas completas a partir de texto · polling assíncrono gerenciado 
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
  }
}
Copiar a configuração MCP para conectar suno
COMO FUNCIONA

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

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.

FAQ

Perguntas sobre Suno + WorkBuddy

Configuração geral do WorkBuddy

Ainda não conectado? Comece com o guia de configuração do RunAPI MCP para WorkBuddy.

Guia de configuração do WorkBuddy →

Catálogo de modelos Suno

Veja todas as versões do Suno, preços e endpoints disponíveis.

Suno no RunAPI →

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 →