--- title: Gebruik Suno in WorkBuddy via RunAPI — Muziek MCP-gids | RunAPI description: Genereer nummers met Suno v4 t/m v5.5 in WorkBuddy via de RunAPI MCP-server. Één sleutel, vocale modi, asynchrone polling afgehandeld door de werkbankagent. url: https://runapi.ai/nl/workbuddy-suno.md canonical: https://runapi.ai/nl/workbuddy-suno locale: nl 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/nl/workbuddy-suno > Site index for agents: https://runapi.ai/llms.txt # Gebruik Suno in WorkBuddy. Suno genereert complete nummers — zang, instrumenten en mixing — vanuit een tekstprompt of eigen songteksten. Versies v4 t/m v5.5 zijn beschikbaar via RunAPI, dat API-toegang biedt omdat Suno geen officiële publieke API heeft. Voeg RunAPI eenmalig toe als MCP-server en de WorkBuddy-agent regelt de asynchrone taak en geeft de voltooide audio-URL terug. - [API Key ophalen](https://runapi.ai/nl/login) - [Lees de documentatie](https://runapi.ai/nl/docs/guides) één MCP-server · complete nummers vanuit tekst · asynchrone polling afgehandeld ### 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-configuratie ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### Antwoord ```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 } } ``` ## Gebruik Suno in WorkBuddy in drie stappen 1. **Voeg RunAPI toe als MCP-server** - Stel RUNAPI_API_KEY in de omgeving in die WorkBuddy start en registreer vervolgens een MCP-server met de naam runapi die verwijst naar https://runapi.ai/mcp via streamable HTTP. Suno verschijnt als een aanroepbare muziek-tool naast elk ander RunAPI-model — geen aparte muziekservice hoeft te worden gekoppeld. `export RUNAPI_API_KEY=runapi_xxx # MCP server: runapi → https://runapi.ai/mcp ` 2. **Beschrijf het nummer aan de agent** - Vertel WorkBuddy wat je wilt in gewone taal en geef de modus op. Gebruik auto_lyrics met een prompt voor door AI geschreven songteksten, exact_lyrics met lyrics/style/title voor je eigen woorden, of instrumental met style/title voor geen zang. De agent vertaalt je beschrijving naar de Suno-tool-aanroep. `vocal_mode: auto_lyrics` 3. **Laat de agent pollen en de audio ophalen** - Nummergeneratie is asynchroon en duurt 30 seconden tot enkele minuten afhankelijk van de versie. De werkbankagent pollt de taak totdat de status voltooid is en plaatst de audio-URL terug in het gesprek — je hebt nooit te maken met een task_id zelf. `"status": "completed"` ## Suno text_to_music-parameters | Parameter | Type | Beschrijving | | --- | --- | --- | | `model` | `string` | Verplicht. suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5 of suno-v5.5. | | `vocal_mode` | `string` | Verplicht. auto_lyrics (AI schrijft songteksten op basis van prompt), exact_lyrics (je levert lyrics/style/title), of instrumental (geen zang, vereist style/title). | | `prompt` | `string` | Nummerbeschrijving voor de auto_lyrics-modus. Beschrijf genre, stemming, tempo en onderwerp. Niet toegestaan in de modi exact_lyrics en instrumental. | | `lyrics` | `string` | Exacte songteksten om te zingen. Verplicht voor de exact_lyrics-modus. Niet toegestaan in de modi auto_lyrics en instrumental. | | `style` | `string` | Beschrijving van de muziekstijl, bijv. lo-fi hip hop, 80s synthwave. Verplicht voor de modi exact_lyrics en instrumental. | | `vocal_gender` | `string` | Optioneel. male of female. | | `negative_tags` | `string` | Optioneel. Te vermijden stijlen, bijv. heavy metal, schreeuwen. | ## Wat is Suno in WorkBuddy? Suno is een tekst-naar-muziek-AI die complete nummers genereert — zang, instrumenten en mixing — vanuit een tekstprompt of je eigen songteksten. Het werkt als een songwriting-schetsblok waarbij je het genre, de stemming en het tempo beschrijft en een volledig nummer terugkrijgt. WorkBuddy bereikt het via de RunAPI MCP-server, omdat Suno geen officiële publieke API heeft, waardoor de werkbankagent programmatische toegang krijgt tot versies v4 t/m v5.5 met dezelfde sleutel die hij gebruikt voor chat en afbeeldingen. ## Suno-toepassingen - **Achtergrondmuziek voor YouTube en sociale media** - Vraag de werkbankagent om originele achtergrondmuziek door de stemming en het genre te beschrijven. Geen licentievergoedingen, geen royaltykosten — het nummer wordt vers gegenereerd voor je content en de URL verschijnt terug in WorkBuddy. - **Songteksten beluisteren als volledig nummer** - Tekstschrijvers kunnen hun woorden in WorkBuddy plakken en vragen om de exact_lyrics-modus met een stijlbeschrijving, en ze horen ze uitgevoerd als een compleet nummer — een productiedemo voordat er studiotijd aan wordt besteed. - **Intros en outros voor podcasts** - Maak instrumentale intro- en outromuziek die aansluit bij de toon van een podcast door genre, stemming en duur op te geven. Laat de agent in één gesprek meerdere variaties genereren en kies de beste. ## Vragen over Suno + WorkBuddy ### Hoe schrijf ik betere Suno-prompts voor het gewenste genre en stijl? Wees specifiek over genre, stemming, tempo en instrumentatie in je beschrijving aan WorkBuddy. Bijvoorbeeld: "opgewekte 120 BPM indie pop met akoestische gitaar en warme synths" werkt beter dan "vrolijk liedje". Vraag de agent om negative_tags door te geven om ongewenste elementen zoals heavy metal of schreeuwen uit te sluiten. ### Welke Suno-versie moet ik gebruiken — v4, v5 of v5.5? suno-v5.5 is de nieuwste versie en levert de hoogste kwaliteit met betere zangstemhelderheid en mixing. suno-v4 en suno-v4.5 zijn goedkoper en sneller voor conceptiteraties. Alle versies zitten achter dezelfde runapi MCP-server, dus wisselen is gewoon een andere versie noemen in je prompt. ### Moet ik de taak zelf pollen in WorkBuddy? Nee. Suno-taken zijn asynchroon, maar de werkbankagent beheert de levenscyclus — hij maakt de taak aan via de MCP-tool, pollt totdat de status voltooid is en plaatst de audio-URL terug in het gesprek. Jij beschrijft alleen het nummer en wacht. ### Biedt RunAPI een officiële Suno API? Suno biedt geen publieke API. RunAPI biedt programmatische toegang tot Suno v4 tot en met v5.5 via dezelfde API-sleutel en taaklevenscyclus als alle andere RunAPI-modellen. Geen Suno-account of afzonderlijke inloggegevens nodig. ### Kan ik het stemgeslacht en stijlgewicht instellen? Ja. Vraag om vocal_gender male of female, en gebruik negative_tags om ongewenste stijlen uit te sluiten. Voor fijnere controle maak je een persona via het personas-endpoint en geef je de teruggegeven persona_id door met persona_type ingesteld op voice of style. - [WorkBuddy-installatiehandleiding →](https://runapi.ai/nl/workbuddy.md) - Nog niet verbonden? Begin met de RunAPI MCP-installatiehandleiding voor WorkBuddy. - [Suno op RunAPI →](https://runapi.ai/nl/models/suno.md) - Bekijk alle Suno-versies, prijzen en beschikbare endpoints. ## Probeer Suno vandaag in WorkBuddy. Haal een gratis RunAPI-sleutel op, voeg de MCP-server toe aan WorkBuddy en beschrijf een nummer — de werkbankagent geeft een volledig nummer terug met zang, instrumenten en mixing. [Modellen bekijken →](https://runapi.ai/nl/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/nl/.md) ### Product - [Modelcatalogus](https://runapi.ai/nl/models.md) - [Prijzen](https://runapi.ai/nl/pricing.md) - [Providers](https://runapi.ai/nl/models#all-models) ### Ontwikkelaars - [Documentatie](https://runapi.ai/nl/docs/guides) - [SDK's](https://runapi.ai/nl/sdk.md) - [CLI](https://runapi.ai/nl/cli.md) - [MCP Server](https://runapi.ai/nl/mcp.md) - [x402](https://runapi.ai/nl/x402.md) ### Gidsen - [Claude Code vs Cursor](https://runapi.ai/nl/claude-code-vs-cursor.md) - [Cursor API instellen](https://runapi.ai/nl/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/nl/openrouter-alternative.md) ### Bedrijf - [Enterprise](https://runapi.ai/nl/contact.md) - [Contact](https://runapi.ai/nl/contact.md) ### Juridisch - [Voorwaarden](https://runapi.ai/nl/terms.md) - [Privacy](https://runapi.ai/nl/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "nl", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/nl", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/nl/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "nl", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/nl", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/nlicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "nl", "@type": "SoftwareApplication", "name": "RunAPI Suno voor WorkBuddy", "applicationCategory": "DeveloperApplication", "description": "Genereer nummers met Suno v4 t/m v5.5 in WorkBuddy via de RunAPI MCP-server. Één sleutel, vocale modi, asynchrone polling afgehandeld door de werkbankagent.", "url": "https://runapi.ai/nl/workbuddy-suno" }, { "@context": "https://schema.org", "inLanguage": "nl", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Hoe schrijf ik betere Suno-prompts voor het gewenste genre en stijl?", "acceptedAnswer": { "@type": "Answer", "text": "Wees specifiek over genre, stemming, tempo en instrumentatie in je beschrijving aan WorkBuddy. Bijvoorbeeld: \"opgewekte 120 BPM indie pop met akoestische gitaar en warme synths\" werkt beter dan \"vrolijk liedje\". Vraag de agent om negative_tags door te geven om ongewenste elementen zoals heavy metal of schreeuwen uit te sluiten." } }, { "@type": "Question", "name": "Welke Suno-versie moet ik gebruiken — v4, v5 of v5.5?", "acceptedAnswer": { "@type": "Answer", "text": "suno-v5.5 is de nieuwste versie en levert de hoogste kwaliteit met betere zangstemhelderheid en mixing. suno-v4 en suno-v4.5 zijn goedkoper en sneller voor conceptiteraties. Alle versies zitten achter dezelfde runapi MCP-server, dus wisselen is gewoon een andere versie noemen in je prompt." } }, { "@type": "Question", "name": "Moet ik de taak zelf pollen in WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "Nee. Suno-taken zijn asynchroon, maar de werkbankagent beheert de levenscyclus — hij maakt de taak aan via de MCP-tool, pollt totdat de status voltooid is en plaatst de audio-URL terug in het gesprek. Jij beschrijft alleen het nummer en wacht." } }, { "@type": "Question", "name": "Biedt RunAPI een officiële Suno API?", "acceptedAnswer": { "@type": "Answer", "text": "Suno biedt geen publieke API. RunAPI biedt programmatische toegang tot Suno v4 tot en met v5.5 via dezelfde API-sleutel en taaklevenscyclus als alle andere RunAPI-modellen. Geen Suno-account of afzonderlijke inloggegevens nodig." } }, { "@type": "Question", "name": "Kan ik het stemgeslacht en stijlgewicht instellen?", "acceptedAnswer": { "@type": "Answer", "text": "Ja. Vraag om vocal_gender male of female, en gebruik negative_tags om ongewenste stijlen uit te sluiten. Voor fijnere controle maak je een persona via het personas-endpoint en geef je de teruggegeven persona_id door met persona_type ingesteld op voice of style." } } ] }, { "@context": "https://schema.org", "inLanguage": "nl", "@type": "HowTo", "name": "Hoe gebruik je Suno in WorkBuddy via RunAPI", "description": "Voeg RunAPI toe als MCP-server in WorkBuddy, beschrijf het nummer aan de werkbankagent en laat hem de asynchrone Suno-taak uitvoeren en de voltooide audio-URL teruggeven.", "step": [ { "@type": "HowToStep", "position": 1, "name": "Voeg RunAPI toe als MCP-server", "text": "Stel RUNAPI_API_KEY in de omgeving in die WorkBuddy start en registreer vervolgens een MCP-server met de naam runapi die verwijst naar https://runapi.ai/mcp via streamable HTTP. Suno verschijnt als een aanroepbare muziek-tool naast elk ander RunAPI-model — geen aparte muziekservice hoeft te worden gekoppeld.", "url": "https://runapi.ai/nl/workbuddy-suno#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Beschrijf het nummer aan de agent", "text": "Vertel WorkBuddy wat je wilt in gewone taal en geef de modus op. Gebruik auto_lyrics met een prompt voor door AI geschreven songteksten, exact_lyrics met lyrics/style/title voor je eigen woorden, of instrumental met style/title voor geen zang. De agent vertaalt je beschrijving naar de Suno-tool-aanroep.", "url": "https://runapi.ai/nl/workbuddy-suno#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Laat de agent pollen en de audio ophalen", "text": "Nummergeneratie is asynchroon en duurt 30 seconden tot enkele minuten afhankelijk van de versie. De werkbankagent pollt de taak totdat de status voltooid is en plaatst de audio-URL terug in het gesprek — je hebt nooit te maken met een task_id zelf.", "url": "https://runapi.ai/nl/workbuddy-suno#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "nl", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://runapi.ai/nl" }, { "@type": "ListItem", "position": 2, "name": "RunAPI Suno voor WorkBuddy", "item": "https://runapi.ai/nl/workbuddy-suno" } ] } ] ```