--- title: Usa Suno en WorkBuddy a través de RunAPI — Guía MCP de Música | RunAPI description: Genera canciones con Suno v4 a v5.5 en WorkBuddy a través del servidor MCP de RunAPI. Una clave, modos vocales, sondeo asíncrono gestionado por el agente del workbench. url: https://runapi.ai/es/workbuddy-suno.md canonical: https://runapi.ai/es/workbuddy-suno locale: es 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/es/workbuddy-suno > Site index for agents: https://runapi.ai/llms.txt # Usa Suno en WorkBuddy. Suno genera canciones completas — voces, instrumentos y mezcla — a partir de un prompt de texto o letras exactas. Las versiones v4 a v5.5 están disponibles a través de RunAPI, que proporciona acceso por API dado que Suno no tiene API pública oficial. Agrega RunAPI como servidor MCP una sola vez, y el agente de WorkBuddy gestiona la tarea asíncrona y devuelve la URL del audio terminado. - [Obtener API Key](https://runapi.ai/es/login) - [Leer la documentación](https://runapi.ai/es/docs/guides) un servidor MCP · canciones completas desde texto · sondeo asíncrono gestionado ### 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. ``` ### Configuración MCP ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### Respuesta ```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 en WorkBuddy en tres pasos 1. **Añade RunAPI como MCP server** - Define RUNAPI_API_KEY en el entorno que inicia WorkBuddy y registra un servidor MCP llamado runapi apuntando a https://runapi.ai/mcp mediante HTTP transmisible. Suno aparece como herramienta de música invocable junto a todos los demás modelos de RunAPI, sin necesidad de conectar un servicio de música aparte. `export RUNAPI_API_KEY=runapi_xxx # MCP server: runapi → https://runapi.ai/mcp ` 2. **Describe la canción al agente** - Indica a WorkBuddy lo que quieres en lenguaje natural y especifica el modo. Usa auto_lyrics con un prompt para letras generadas por IA, exact_lyrics con lyrics/style/title para tus propias palabras, o instrumental con style/title para versiones sin voz. El agente traduce tu descripción en la llamada a la herramienta Suno. `vocal_mode: auto_lyrics` 3. **Deja que el agente sondee y recoja el audio** - La generación de canciones es asíncrona y tarda entre 30 segundos y varios minutos según la versión. El agente del banco de trabajo sondea la tarea hasta que el estado es completed y luego publica la URL del audio de salida en la conversación; tú nunca tienes que gestionar un task_id. `"status": "completed"` ## Parámetros de text_to_music de Suno | Parámetro | Tipo | Descripción | | --- | --- | --- | | `model` | `string` | Obligatorio. suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5 o suno-v5.5. | | `vocal_mode` | `string` | Obligatorio. auto_lyrics (la IA escribe la letra a partir del prompt), exact_lyrics (tú proporcionas lyrics/style/title) o instrumental (sin voz, requiere style/title). | | `prompt` | `string` | Descripción de la canción para el modo auto_lyrics. Describe el género, el estado de ánimo, el tempo y el tema. Prohibido en los modos exact_lyrics e instrumental. | | `lyrics` | `string` | Letra exacta a cantar. Obligatorio para el modo exact_lyrics. Prohibido en los modos auto_lyrics e instrumental. | | `style` | `string` | Descripción del estilo musical, p. ej. lo-fi hip hop, synthwave de los 80. Obligatorio para los modos exact_lyrics e instrumental. | | `vocal_gender` | `string` | Opcional. male o female. | | `negative_tags` | `string` | Opcional. Estilos a evitar, p. ej. heavy metal, screaming. | ## ¿Qué es Suno en WorkBuddy? Suno es una IA de texto a música que genera canciones completas —voz, instrumentos y mezcla— a partir de un prompt de texto o de tu propia letra. Funciona como bloc de notas para composición: describes el género, el estado de ánimo y el tempo, y obtienes una pista completa. WorkBuddy accede a él a través del servidor MCP de RunAPI, ya que Suno no dispone de API pública oficial, lo que le da al agente del banco de trabajo acceso programático a las versiones v4 a v5.5 con la misma clave que usa para chat e imágenes. ## Casos de uso de Suno - **Música de fondo para YouTube y redes sociales** - Pide al agente del banco de trabajo pistas de fondo originales describiendo el estado de ánimo y el género. Sin tarifas de licencia ni problemas de derechos: la pista se genera de cero para tu contenido y la URL llega directamente a WorkBuddy. - **Escuchar letras como canción completa** - Los letristas pueden pegar sus palabras en WorkBuddy y solicitar el modo exact_lyrics con una descripción de estilo, y escucharlas interpretadas como una canción completa: una demo de producción antes de entrar al estudio. - **Intros y outros para podcasts** - Crea música instrumental de introducción y cierre adaptada al tono de un podcast especificando género, estado de ánimo y duración. Pide al agente que genere varias variaciones en una misma conversación y elige la que mejor encaje. ## Preguntas sobre Suno + WorkBuddy ### ¿Cómo escribo mejores prompts para Suno y obtengo el género y el estilo que quiero? Sé específico sobre género, estado de ánimo, tempo e instrumentación en tu descripción a WorkBuddy. Por ejemplo, "indie pop animado a 120 BPM con guitarra acústica y sintetizadores cálidos" funciona mejor que "canción alegre". Pide al agente que pase negative_tags para excluir elementos no deseados como heavy metal o voces agresivas. ### ¿Qué versión de Suno debo usar: v4, v5 o v5.5? suno-v5.5 es la versión más reciente y produce la salida de mayor calidad, con mejor claridad vocal y mezcla. suno-v4 y suno-v4.5 son más económicos y rápidos para iteraciones de borrador. Todas las versiones están detrás del mismo servidor MCP runapi, así que cambiar de versión solo requiere nombrar una diferente en tu prompt. ### ¿Tengo que sondear la tarea yo mismo en WorkBuddy? No. Las tareas de Suno son asíncronas, pero el agente del banco de trabajo gestiona todo el ciclo: crea la tarea a través de la herramienta MCP, sondea hasta que el estado es completed y publica la URL del audio en la conversación. Tú solo describes la canción y esperas. ### ¿RunAPI ofrece una API oficial de Suno? Suno no dispone de una API pública. RunAPI proporciona acceso programático a Suno v4 hasta v5.5 mediante la misma API key y el mismo ciclo de vida de tareas que se usa para todos los demás modelos de RunAPI. No se necesita cuenta de Suno ni credenciales adicionales. ### ¿Puedo controlar el género de voz y el peso del estilo? Sí. Pide vocal_gender male o female y usa negative_tags para excluir estilos no deseados. Para un control más fino, crea una persona a través del endpoint personas y pasa el persona_id devuelto con persona_type establecido en voice o style. - [Guía de configuración de WorkBuddy →](https://runapi.ai/es/workbuddy.md) - ¿Aún no está conectado? Comienza con la guía de configuración del MCP de RunAPI para WorkBuddy. - [Suno en RunAPI →](https://runapi.ai/es/models/suno.md) - Ver todas las versiones de Suno, precios y endpoints disponibles. ## Prueba Suno en WorkBuddy hoy mismo. Obtén una clave RunAPI gratuita, agrega el servidor MCP a WorkBuddy y describe una canción: el agente del banco de trabajo devuelve una pista completa con voz, instrumentos y mezcla. [Explorar modelos →](https://runapi.ai/es/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/es/.md) ### Producto - [Catálogo de modelos](https://runapi.ai/es/models.md) - [Precios](https://runapi.ai/es/pricing.md) - [Proveedores](https://runapi.ai/es/models#all-models) ### Desarrolladores - [Documentación](https://runapi.ai/es/docs/guides) - [SDKs](https://runapi.ai/es/sdk.md) - [CLI](https://runapi.ai/es/cli.md) - [Servidor MCP](https://runapi.ai/es/mcp.md) - [x402](https://runapi.ai/es/x402.md) ### Guías - [Claude Code vs Cursor](https://runapi.ai/es/claude-code-vs-cursor.md) - [Configuración de Cursor API](https://runapi.ai/es/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/es/openrouter-alternative.md) ### Empresa - [Enterprise](https://runapi.ai/es/contact.md) - [Contacto](https://runapi.ai/es/contact.md) ### Legal - [Términos](https://runapi.ai/es/terms.md) - [Privacidad](https://runapi.ai/es/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "es", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/es", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/es/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/es", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/esicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "SoftwareApplication", "name": "RunAPI Suno para WorkBuddy", "applicationCategory": "DeveloperApplication", "description": "Genera canciones con Suno v4 a v5.5 en WorkBuddy a través del servidor MCP de RunAPI. Una clave, modos vocales, sondeo asíncrono gestionado por el agente del workbench.", "url": "https://runapi.ai/es/workbuddy-suno" }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "¿Cómo escribo mejores prompts para Suno y obtengo el género y el estilo que quiero?", "acceptedAnswer": { "@type": "Answer", "text": "Sé específico sobre género, estado de ánimo, tempo e instrumentación en tu descripción a WorkBuddy. Por ejemplo, \"indie pop animado a 120 BPM con guitarra acústica y sintetizadores cálidos\" funciona mejor que \"canción alegre\". Pide al agente que pase negative_tags para excluir elementos no deseados como heavy metal o voces agresivas." } }, { "@type": "Question", "name": "¿Qué versión de Suno debo usar: v4, v5 o v5.5?", "acceptedAnswer": { "@type": "Answer", "text": "suno-v5.5 es la versión más reciente y produce la salida de mayor calidad, con mejor claridad vocal y mezcla. suno-v4 y suno-v4.5 son más económicos y rápidos para iteraciones de borrador. Todas las versiones están detrás del mismo servidor MCP runapi, así que cambiar de versión solo requiere nombrar una diferente en tu prompt." } }, { "@type": "Question", "name": "¿Tengo que sondear la tarea yo mismo en WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "No. Las tareas de Suno son asíncronas, pero el agente del banco de trabajo gestiona todo el ciclo: crea la tarea a través de la herramienta MCP, sondea hasta que el estado es completed y publica la URL del audio en la conversación. Tú solo describes la canción y esperas." } }, { "@type": "Question", "name": "¿RunAPI ofrece una API oficial de Suno?", "acceptedAnswer": { "@type": "Answer", "text": "Suno no dispone de una API pública. RunAPI proporciona acceso programático a Suno v4 hasta v5.5 mediante la misma API key y el mismo ciclo de vida de tareas que se usa para todos los demás modelos de RunAPI. No se necesita cuenta de Suno ni credenciales adicionales." } }, { "@type": "Question", "name": "¿Puedo controlar el género de voz y el peso del estilo?", "acceptedAnswer": { "@type": "Answer", "text": "Sí. Pide vocal_gender male o female y usa negative_tags para excluir estilos no deseados. Para un control más fino, crea una persona a través del endpoint personas y pasa el persona_id devuelto con persona_type establecido en voice o style." } } ] }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "HowTo", "name": "Cómo usar Suno en WorkBuddy mediante RunAPI", "description": "Agrega RunAPI como servidor MCP en WorkBuddy, describe la canción al agente del banco de trabajo y deja que ejecute la tarea asíncrona de Suno y devuelva la URL del audio terminado.", "step": [ { "@type": "HowToStep", "position": 1, "name": "Añade RunAPI como MCP server", "text": "Define RUNAPI_API_KEY en el entorno que inicia WorkBuddy y registra un servidor MCP llamado runapi apuntando a https://runapi.ai/mcp mediante HTTP transmisible. Suno aparece como herramienta de música invocable junto a todos los demás modelos de RunAPI, sin necesidad de conectar un servicio de música aparte.", "url": "https://runapi.ai/es/workbuddy-suno#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Describe la canción al agente", "text": "Indica a WorkBuddy lo que quieres en lenguaje natural y especifica el modo. Usa auto_lyrics con un prompt para letras generadas por IA, exact_lyrics con lyrics/style/title para tus propias palabras, o instrumental con style/title para versiones sin voz. El agente traduce tu descripción en la llamada a la herramienta Suno.", "url": "https://runapi.ai/es/workbuddy-suno#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Deja que el agente sondee y recoja el audio", "text": "La generación de canciones es asíncrona y tarda entre 30 segundos y varios minutos según la versión. El agente del banco de trabajo sondea la tarea hasta que el estado es completed y luego publica la URL del audio de salida en la conversación; tú nunca tienes que gestionar un task_id.", "url": "https://runapi.ai/es/workbuddy-suno#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Inicio", "item": "https://runapi.ai/es" }, { "@type": "ListItem", "position": 2, "name": "RunAPI Suno para WorkBuddy", "item": "https://runapi.ai/es/workbuddy-suno" } ] } ] ```