Use Suno in OpenClaw.
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. OpenClaw agents call it with the same RUNAPI_API_KEY used for chat.
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"
}
Use Suno in OpenClaw in three steps
Configure RunAPI
Set RUNAPI_API_KEY in your environment. If you already configured RunAPI in OpenClaw for chat, the same key works for Suno music generation — no extra provider setup needed.
export RUNAPI_API_KEY=runapi_xxx
Call text_to_music
Send a POST to the text_to_music endpoint with the model and vocal_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.
POST /api/v1/suno/text_to_music
Poll for the result
The endpoint returns a task_id immediately. Song generation takes 30 seconds to several minutes depending on version. Poll the task status endpoint until the status is completed, then read the output audio URL.
GET /api/v1/suno/text_to_music/tsk_abc123
Suno text_to_music API 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. |
title |
string |
Song title. 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. |
duration_seconds |
integer |
Optional. Target duration in seconds. |
persona_id |
string |
Optional. Persona ID for custom voice or style profiles. |
persona_type |
string |
Optional. style or voice. Selects the persona category. |
callback_url |
string |
Optional. Webhook URL that receives a POST when the task completes. |
What is Suno on OpenClaw?
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. OpenClaw agents call it through RunAPI since Suno has no official public API, giving you programmatic access to versions v4 through v5.5.
Suno use cases
Background music for YouTube and social media
Generate original background tracks for videos by describing the mood and genre in a prompt. No licensing fees, no royalty issues -- the track is generated fresh for your content.
Hearing lyrics as a full song
Lyric writers can paste their words into exact_lyrics mode with a style description and hear them performed as a complete song, turning written lyrics into 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. Generate several variations and pick the best fit.
Suno + OpenClaw questions
Be specific about genre, mood, tempo, and instrumentation in your prompt. For example, "upbeat 120 BPM indie pop with acoustic guitar and warm synths" works better than "happy song." Use negative_tags to exclude unwanted elements like "heavy metal" or "screaming." Meta tags in the prompt help Suno understand structure.
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 use the same text_to_music endpoint and parameters.
Yes. Use the extend_music endpoint to continue a song from a specific timestamp. You can chain multiple extensions to build longer tracks. RunAPI also offers cover_audio to restyle existing tracks and create_mashup to combine elements from multiple songs.
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.
Yes. Set vocal_gender to male or female. Use negative_tags to exclude unwanted styles. For finer control, create a persona through the generate_persona endpoint and pass the returned persona_id with persona_type set to voice or style.
OpenClaw general setup
Not configured yet? Start with the RunAPI setup guide for OpenClaw.
OpenClaw setup guide →Try Suno in OpenClaw today.
Get a free RunAPI key, paste the prompt into OpenClaw, and generate full songs with vocals, instruments, and mixing from a text description.