Gebruik Suno in OpenClaw.
Suno genereert volledige nummers — zang, instrumenten en mixing — vanuit een tekstprompt of exacte songteksten. Versies v4 tot en met v5.5 zijn beschikbaar via RunAPI, dat API-toegang biedt aangezien Suno geen officiële openbare API heeft. OpenClaw-agents roepen het aan met dezelfde RUNAPI_API_KEY die voor chat wordt gebruikt.
Use RunAPI to generate a song with Suno.
Requirements:
- Read the API key from RUNAPI_API_KEY.
- Call POST https://runapi.ai/api/v1/suno/text_to_music
- Set model to "suno-v5.5".
- Set vocal_mode to "auto_lyrics" for AI-generated lyrics from a prompt.
- Set prompt to describe the song you want.
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the audio URL from the response output.
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v5.5",
"vocal_mode": "auto_lyrics",
"prompt": "An upbeat indie pop track about coding late at night, warm synths and acoustic guitar",
"vocal_gender": "female"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "suno-v5.5"
}
Gebruik Suno in OpenClaw in drie stappen
Configureer RunAPI
Stel RUNAPI_API_KEY in als omgevingsvariabele. Als je RunAPI al in OpenClaw hebt geconfigureerd voor chat, werkt dezelfde sleutel voor Suno-muziekgeneratie — geen extra providerconfiguratie nodig.
export RUNAPI_API_KEY=runapi_xxx
Roep text_to_music aan
Stuur een POST naar het text_to_music-endpoint met het model en vocal_mode. 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 een track zonder zang.
POST /api/v1/suno/text_to_music
Poll voor het resultaat
Het endpoint retourneert direct een task_id. Nummergeneratie duurt 30 seconden tot enkele minuten afhankelijk van de versie. Poll het taakstatusendpoint totdat de status voltooid is en lees vervolgens de uitvoer-audio-URL.
GET /api/v1/suno/text_to_music/tsk_abc123
Suno text_to_music API-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 vanuit prompt), exact_lyrics (je levert songteksten/stijl/titel aan) of instrumental (geen zang, vereist stijl/titel). |
prompt |
string |
Nummerbeschrijving voor auto_lyrics-modus. Beschrijf genre, stemming, tempo en onderwerp. Verboden in exact_lyrics- en instrumental-modi. |
lyrics |
string |
Exacte songteksten om te zingen. Verplicht voor exact_lyrics-modus. Verboden in auto_lyrics- en instrumental-modi. |
style |
string |
Muziekstijlbeschrijving, bijv. lo-fi hip hop, 80s synthwave. Verplicht voor exact_lyrics- en instrumental-modi. |
title |
string |
Nummertitel. Verplicht voor exact_lyrics- en instrumental-modi. |
vocal_gender |
string |
Optioneel. male of female. |
negative_tags |
string |
Optioneel. Stijlen om te vermijden, bijv. heavy metal, screaming. |
duration_seconds |
integer |
Optioneel. Doelduur in seconden. |
persona_id |
string |
Optioneel. Persona-ID voor aangepaste stem- of stijlprofielen. |
persona_type |
string |
Optioneel. style of voice. Selecteert de personacategorie. |
callback_url |
string |
Optioneel. Webhook-URL die een POST ontvangt wanneer de taak is voltooid. |
Wat is Suno in OpenClaw?
Suno is een tekst-naar-muziek-AI die complete nummers genereert — zang, instrumenten en productie — vanuit een tekstprompt. Het ondersteunt exacte lyrieksmodus, continue generatie voor langere nummers en genre-gestuurde compositie. OpenClaw-agents roepen het aan via RunAPI met dezelfde API-sleutel als voor chat.
Suno-toepassingen
Achtergondmuziek voor YouTube en sociale media
Genereer originele achtergondtracks voor video's door genre, sfeer en tempo te beschrijven.
Teksten beluisteren als volledig nummer
Tekstschrijvers kunnen hun woorden in de exacte_lyrics-modus plakken om te horen hoe ze als volledig nummer klinken.
Podcast-intro's en -outro's
Maak instrumentale intro- en outromuziek afgestemd op de sfeer en het formaat van een podcast.
Vragen over Suno + OpenClaw
auto_lyrics genereert songteksten vanuit je prompt — je beschrijft het nummer en Suno schrijft de woorden. exact_lyrics gebruikt de tekst die je aanlevert letterlijk en vereist de velden style en title. instrumental produceert een track zonder zang, met alleen style en title.
suno-v5.5 is de nieuwste versie en produceert de hoogste kwaliteit met betere vocale helderheid en mixing. suno-v4 en suno-v4.5 zijn goedkoper en sneller voor conceptiteraties. Alle versies gebruiken hetzelfde text_to_music-endpoint en dezelfde parameters.
Generatietijd varieert per versie en nummerlengte. Typische doorlooptijd is 30 seconden tot 2 minuten. De API retourneert direct een task_id — poll het statusendpoint of stel een callback_url in om je agent niet te blokkeren.
Suno biedt geen openbare API aan. RunAPI biedt programmatische toegang tot Suno v4 tot en met v5.5 via dezelfde API-sleutel en taaklevenscyclus die voor alle andere RunAPI-modellen worden gebruikt. Geen Suno-account of aparte inloggegevens nodig.
Ja. Stel vocal_gender in op male of female. Gebruik negative_tags om ongewenste stijlen uit te sluiten. Maak voor meer controle een persona aan via het generate_persona-endpoint en geef de geretourneerde persona_id mee met persona_type ingesteld op voice of style.
Algemene OpenClaw-configuratie
Nog niet geconfigureerd? Begin met de RunAPI-configuratiegids voor OpenClaw.
OpenClaw-configuratiegids →Probeer Suno in OpenClaw vandaag.
Haal een gratis RunAPI-sleutel, plak de prompt in OpenClaw en genereer volledige nummers met zang, instrumenten en mixing vanuit een tekstbeschrijving.