--- title: Use Suno in WorkBuddy via RunAPI — Music MCP Guide | RunAPI description: Generate songs with Suno v4 to v5.5 in WorkBuddy through the RunAPI MCP server. One key, vocal modes, async polling handled by the workbench agent. url: https://runapi.ai/workbuddy-suno.md canonical: https://runapi.ai/workbuddy-suno locale: en 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/workbuddy-suno > Site index for agents: https://runapi.ai/llms.txt # Use Suno in WorkBuddy. Suno generates full songs — vocals, instruments, and mixing — from a text prompt or exact lyrics. Versions v4 through v5.5 are available through RunAPI, which provides API access since Suno has no official public API. Add RunAPI as an MCP server once, and the WorkBuddy agent handles the async task and hands back the finished audio URL. - [Get API Key](https://runapi.ai/login) - [Read the docs](https://runapi.ai/docs/guides) one MCP server · full songs from text · async polling handled ### 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. ``` ### MCP config ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### Response ```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 Suno in WorkBuddy in three steps 1. **Add RunAPI as an MCP server** - Set RUNAPI_API_KEY in the environment that launches WorkBuddy, then register an MCP server named runapi pointing at https://runapi.ai/mcp over streamable HTTP. Suno appears as a callable music tool alongside every other RunAPI model — no separate music service to wire up. `export RUNAPI_API_KEY=runapi_xxx # MCP server: runapi → https://runapi.ai/mcp ` 2. **Describe the song to the agent** - Tell WorkBuddy what you want in plain language and name the mode. Use auto_lyrics with a prompt for AI-written lyrics, exact_lyrics with lyrics/style/title for your own words, or instrumental with style/title for no vocals. The agent maps your brief onto the Suno tool call. `vocal_mode: auto_lyrics` 3. **Let the agent poll and collect the audio** - Song generation is async and takes 30 seconds to several minutes depending on version. The workbench agent polls the task until the status is completed, then posts the output audio URL back into the conversation — you never touch a task_id yourself. `"status": "completed"` ## Suno text_to_music parameters | Parameter | Type | Description | | --- | --- | --- | | `model` | `string` | Required. suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5, or suno-v5.5. | | `vocal_mode` | `string` | Required. auto_lyrics (AI writes lyrics from prompt), exact_lyrics (you provide lyrics/style/title), or instrumental (no vocals, requires style/title). | | `prompt` | `string` | Song brief for auto_lyrics mode. Describe genre, mood, tempo, and subject. Forbidden in exact_lyrics and instrumental modes. | | `lyrics` | `string` | Exact lyrics to sing. Required for exact_lyrics mode. Forbidden in auto_lyrics and instrumental modes. | | `style` | `string` | Music style description, e.g. lo-fi hip hop, 80s synthwave. Required for exact_lyrics and instrumental modes. | | `vocal_gender` | `string` | Optional. male or female. | | `negative_tags` | `string` | Optional. Styles to avoid, e.g. heavy metal, screaming. | ## What is Suno on WorkBuddy? Suno is a text-to-music AI that generates complete songs -- vocals, instruments, and mixing -- from a text prompt or your own lyrics. It works as a songwriting sketchpad where you describe the genre, mood, and tempo, and get back a full track. WorkBuddy reaches it through the RunAPI MCP server since Suno has no official public API, giving the workbench agent programmatic access to versions v4 through v5.5 with the same key it uses for chat and images. ## Suno use cases - **Background music for YouTube and social media** - Ask the workbench agent for original background tracks by describing the mood and genre. No licensing fees, no royalty issues -- the track is generated fresh for your content and the URL lands back in WorkBuddy. - **Hearing lyrics as a full song** - Lyric writers can paste their words into WorkBuddy and ask for exact_lyrics mode with a style description, hearing them performed as a complete song — a production demo before studio time. - **Podcast intros and outros** - Create instrumental intro and outro music matched to a podcast's tone by specifying genre, mood, and duration. Have the agent generate several variations in one conversation and pick the best fit. ## Suno + WorkBuddy questions ### How do I write better Suno prompts to get the genre and style I want? Be specific about genre, mood, tempo, and instrumentation in your brief to WorkBuddy. For example, "upbeat 120 BPM indie pop with acoustic guitar and warm synths" works better than "happy song." Ask the agent to pass negative_tags to exclude unwanted elements such as heavy metal or screaming. ### Which Suno version should I use -- v4, v5, or v5.5? suno-v5.5 is the latest and produces the highest quality output with better vocal clarity and mixing. suno-v4 and suno-v4.5 are cheaper and faster for draft iterations. All versions sit behind the same runapi MCP server, so switching is just naming a different version in your prompt. ### Do I have to poll the task myself in WorkBuddy? No. Suno tasks are async, but the workbench agent handles the lifecycle — it creates the task through the MCP tool, polls until the status is completed, and posts the audio URL back into the conversation. You just describe the song and wait. ### Does RunAPI provide an official Suno API? Suno does not offer a public API. RunAPI provides programmatic access to Suno v4 through v5.5 through the same API key and task lifecycle used for all other RunAPI models. No Suno account or separate credentials needed. ### Can I control the voice gender and style weight? Yes. Ask for vocal_gender male or female, and use negative_tags to exclude unwanted styles. For finer control, create a persona through the personas endpoint and pass the returned persona_id with persona_type set to voice or style. - [WorkBuddy setup guide →](https://runapi.ai/workbuddy.md) - Not connected yet? Start with the RunAPI MCP setup guide for WorkBuddy. - [Suno on RunAPI →](https://runapi.ai/models/suno.md) - See all Suno versions, pricing, and available endpoints. ## Try Suno in WorkBuddy today. Get a free RunAPI key, add the MCP server to WorkBuddy, and describe a song — the workbench agent returns a full track with vocals, instruments, and mixing. [Browse models →](https://runapi.ai/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/.md) ### Product - [Model Catalog](https://runapi.ai/models.md) - [Pricing](https://runapi.ai/pricing.md) - [Providers](https://runapi.ai/models#all-models) ### Developers - [Documentation](https://runapi.ai/docs/guides) - [SDKs](https://runapi.ai/sdk.md) - [CLI](https://runapi.ai/cli.md) - [MCP Server](https://runapi.ai/mcp.md) - [x402](https://runapi.ai/x402.md) ### Guides - [Claude Code vs Cursor](https://runapi.ai/claude-code-vs-cursor.md) - [Cursor API Setup](https://runapi.ai/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/openrouter-alternative.md) ### Company - [Enterprise](https://runapi.ai/contact.md) - [Contact](https://runapi.ai/contact.md) ### Legal - [Terms](https://runapi.ai/terms.md) - [Privacy](https://runapi.ai/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "en", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/icon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "SoftwareApplication", "name": "RunAPI Suno for WorkBuddy", "applicationCategory": "DeveloperApplication", "description": "Generate songs with Suno v4 to v5.5 in WorkBuddy through the RunAPI MCP server. One key, vocal modes, async polling handled by the workbench agent.", "url": "https://runapi.ai/workbuddy-suno" }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "How do I write better Suno prompts to get the genre and style I want?", "acceptedAnswer": { "@type": "Answer", "text": "Be specific about genre, mood, tempo, and instrumentation in your brief to WorkBuddy. For example, \"upbeat 120 BPM indie pop with acoustic guitar and warm synths\" works better than \"happy song.\" Ask the agent to pass negative_tags to exclude unwanted elements such as heavy metal or screaming." } }, { "@type": "Question", "name": "Which Suno version should I use -- v4, v5, or v5.5?", "acceptedAnswer": { "@type": "Answer", "text": "suno-v5.5 is the latest and produces the highest quality output with better vocal clarity and mixing. suno-v4 and suno-v4.5 are cheaper and faster for draft iterations. All versions sit behind the same runapi MCP server, so switching is just naming a different version in your prompt." } }, { "@type": "Question", "name": "Do I have to poll the task myself in WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "No. Suno tasks are async, but the workbench agent handles the lifecycle — it creates the task through the MCP tool, polls until the status is completed, and posts the audio URL back into the conversation. You just describe the song and wait." } }, { "@type": "Question", "name": "Does RunAPI provide an official Suno API?", "acceptedAnswer": { "@type": "Answer", "text": "Suno does not offer a public API. RunAPI provides programmatic access to Suno v4 through v5.5 through the same API key and task lifecycle used for all other RunAPI models. No Suno account or separate credentials needed." } }, { "@type": "Question", "name": "Can I control the voice gender and style weight?", "acceptedAnswer": { "@type": "Answer", "text": "Yes. Ask for vocal_gender male or female, and use negative_tags to exclude unwanted styles. For finer control, create a persona through the personas endpoint and pass the returned persona_id with persona_type set to voice or style." } } ] }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "HowTo", "name": "How to use Suno in WorkBuddy via RunAPI", "description": "Add RunAPI as an MCP server in WorkBuddy, describe the song to the workbench agent, and let it run the async Suno task and return the finished audio URL.", "step": [ { "@type": "HowToStep", "position": 1, "name": "Add RunAPI as an MCP server", "text": "Set RUNAPI_API_KEY in the environment that launches WorkBuddy, then register an MCP server named runapi pointing at https://runapi.ai/mcp over streamable HTTP. Suno appears as a callable music tool alongside every other RunAPI model — no separate music service to wire up.", "url": "https://runapi.ai/workbuddy-suno#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Describe the song to the agent", "text": "Tell WorkBuddy what you want in plain language and name the mode. Use auto_lyrics with a prompt for AI-written lyrics, exact_lyrics with lyrics/style/title for your own words, or instrumental with style/title for no vocals. The agent maps your brief onto the Suno tool call.", "url": "https://runapi.ai/workbuddy-suno#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Let the agent poll and collect the audio", "text": "Song generation is async and takes 30 seconds to several minutes depending on version. The workbench agent polls the task until the status is completed, then posts the output audio URL back into the conversation — you never touch a task_id yourself.", "url": "https://runapi.ai/workbuddy-suno#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://runapi.ai/" }, { "@type": "ListItem", "position": 2, "name": "RunAPI Suno for WorkBuddy", "item": "https://runapi.ai/workbuddy-suno" } ] } ] ```