Examples for using suno-v4 through RunAPI from agent tools or API calls. Copy a prompt, then use it in Claude Code, Codex, Cursor, Windsurf, or your backend.
1. claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
2. Restart Claude Code
3. Paste this prompt: Generate music: "Indie folk, 92 BPM, melancholic, fingerstyle acoustic guitar, whispered vocals, 2010s indie style"1. codex plugin install runapi-mcp@agents
2. Restart Codex
3. Paste this prompt: Generate music: "Indie folk, 92 BPM, melancholic, fingerstyle acoustic guitar, whispered vocals, 2010s indie style"1. npx @runapi.ai/mcp init cursor
2. Restart Cursor
3. Paste this prompt: Generate music: "Indie folk, 92 BPM, melancholic, fingerstyle acoustic guitar, whispered vocals, 2010s indie style"1. npx @runapi.ai/mcp init windsurf
2. Restart Windsurf
3. Paste this prompt: Generate music: "Indie folk, 92 BPM, melancholic, fingerstyle acoustic guitar, whispered vocals, 2010s indie style"curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Indie folk, 92 BPM, melancholic, fingerstyle acoustic guitar, whispered vocals, 2010s indie style"
}
JSONimport { SunoClient } from "@runapi.ai/suno";
const client = new SunoClient({
apiKey: process.env.RUNAPI_API_KEY,
});
const result = await client.textToMusic.run({
"model": "suno-v4",
"prompt": "Indie folk, 92 BPM, melancholic, fingerstyle acoustic guitar, whispered vocals, 2010s indie style"
});
console.log(result.id);require "runapi/suno"
client = RunApi::Suno::Client.new
result = client.text_to_music.run(
model: "suno-v4",
prompt: "Indie folk, 92 BPM, melancholic, fingerstyle acoustic guitar, whispered vocals, 2010s indie style"
)
puts result.idpackage main
import (
"context"
"fmt"
"log"
"net/http"
"os"
"strings"
)
func main() {
body := strings.NewReader("{\"model\":\"suno-v4\",\"prompt\":\"Indie folk, 92 BPM, melancholic, fingerstyle acoustic guitar, whispered vocals, 2010s indie style\"}")
req, err := http.NewRequestWithContext(context.Background(), http.MethodPost, "https://runapi.ai/api/v1/suno/text_to_music", body)
if err != nil {
log.Fatal(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("RUNAPI_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
fmt.Println(resp.Status)
}Alternative Rock, Experimental, Atmospheric
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Alternative Rock, Experimental, Atmospheric"
}
JSONPost-Rock, Ethereal, Atmospheric, Icelandic
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Post-Rock, Ethereal, Atmospheric, Icelandic"
}
JSONgregorian chorale, choir, carried singing, epic, majestic, ecclesiastical
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "gregorian chorale, choir, carried singing, epic, majestic, ecclesiastical"
}
JSONmath rock, J-pop, mutation funk, bounce drop, dubstep, edm, 160bpm
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "math rock, J-pop, mutation funk, bounce drop, dubstep, edm, 160bpm"
}
JSONPentatonic Scale, Modern Classic, Game Music, Guzheng & Piano & Chinese Drum & Cello, Slow, Sad, Mellow
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Pentatonic Scale, Modern Classic, Game Music, Guzheng & Piano & Chinese Drum & Cello, Slow, Sad, Mellow"
}
JSONanime opening, heavy metal, male vocal
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "anime opening, heavy metal, male vocal"
}
JSONUplifting atmospheric worship ballad with ethereal vocals and sweeping orchestral arrangements
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Uplifting atmospheric worship ballad with ethereal vocals and sweeping orchestral arrangements"
}
JSONBaroque pop, intricate melodies, orchestral arrangements, harpsichord flourishes, and poetic lyrics
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Baroque pop, intricate melodies, orchestral arrangements, harpsichord flourishes, and poetic lyrics"
}
JSONTropical house, upbeat, sun-kissed melodies, steel drums, breezy vocals, and a laid-back rhythm
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Tropical house, upbeat, sun-kissed melodies, steel drums, breezy vocals, and a laid-back rhythm"
}
JSONPsychedelic funk, groovy bass lines, wah-wah guitars, trippy effects, and energetic brass sections
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Psychedelic funk, groovy bass lines, wah-wah guitars, trippy effects, and energetic brass sections"
}
JSONBalkan electro swing, energetic brass ensembles, electronic beats, folk melodies, and dance rhythms
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Balkan electro swing, energetic brass ensembles, electronic beats, folk melodies, and dance rhythms"
}
JSONDark ambient, atmospheric soundscapes, slow-moving textures, and an unsettling, eerie mood
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Dark ambient, atmospheric soundscapes, slow-moving textures, and an unsettling, eerie mood"
}
JSONIndie surf rock, jangly guitars, beachy vibes, carefree vocals, and upbeat, sunny melodies
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Indie surf rock, jangly guitars, beachy vibes, carefree vocals, and upbeat, sunny melodies"
}
JSONCinematic gospel arrangement with choir support, organ, wider reverb, slower rise into chorus, and a more dramatic lead vocal
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Cinematic gospel arrangement with choir support, organ, wider reverb, slower rise into chorus, and a more dramatic lead vocal"
}
JSONTransform this into a warm acoustic soul version with gentle electric piano, restrained drums, intimate male vocal, steady groove, preserve the original chorus melody, avoid EDM drops and heavy distortion
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Transform this into a warm acoustic soul version with gentle electric piano, restrained drums, intimate male vocal, steady groove, preserve the original chorus melody, avoid EDM drops and heavy distortion"
}
JSON[Intro: ambient pads, reversed guitar, ethereal] [Verse 1: lo-fi drums, muted bass, whispered vocals] Walking through the rain at midnight Neon signs reflecting off the street [Pre-Chorus: building energy, adding layers] Something in the air is changing I can feel it pulling at my feet [Chorus: full production, soaring vocals, epic drums] We are the light that never fades Burning through the endless maze [Bridge: stripped down, piano only, vulnerable vocals] All the words I never said Echo softly in my head [Outro: fade out, ambient reprise]
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "[Intro: ambient pads, reversed guitar, ethereal] [Verse 1: lo-fi drums, muted bass, whispered vocals] Walking through the rain at midnight Neon signs reflecting off the street [Pre-Chorus: building energy, adding layers] Something in the air is changing I can feel it pulling at my feet [Chorus: full production, soaring vocals, epic drums] We are the light that never fades Burning through the endless maze [Bridge: stripped down, piano only, vulnerable vocals] All the words I never said Echo softly in my head [Outro: fade out, ambient reprise]"
}
JSON[Verse] soft acoustic guitar the morning light filters through [Chorus] soaring vocals with full band we rise above the clouds [Bridge: piano only, vulnerable vocals] all the weight we carry [Outro: fade out]
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "[Verse] soft acoustic guitar the morning light filters through [Chorus] soaring vocals with full band we rise above the clouds [Bridge: piano only, vulnerable vocals] all the weight we carry [Outro: fade out]"
}
JSONGarage rock, raw and aggressive, distorted bass, room mic drums, shouted male vocals, lo-fi production
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Garage rock, raw and aggressive, distorted bass, room mic drums, shouted male vocals, lo-fi production"
}
JSONJazz-funk fusion, slap bass, Rhodes piano, syncopated drums, groovy and sophisticated
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Jazz-funk fusion, slap bass, Rhodes piano, syncopated drums, groovy and sophisticated"
}
JSON80s synthwave meets modern trap, analog synths, 808 bass, retro-futuristic
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "80s synthwave meets modern trap, analog synths, 808 bass, retro-futuristic"
}
JSONCinematic orchestral score, sweeping strings, French horns, timpani rolls, epic and triumphant, Hans Zimmer inspired
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Cinematic orchestral score, sweeping strings, French horns, timpani rolls, epic and triumphant, Hans Zimmer inspired"
}
JSONAmbient electronic, pad textures, slow evolving synths, ethereal and spacious, Brian Eno inspired
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "Ambient electronic, pad textures, slow evolving synths, ethereal and spacious, Brian Eno inspired"
}
JSON[Outro: fade out, ambient reprise]
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "[Outro: fade out, ambient reprise]"
}
JSON[Build-Up] [Drop: full energy, heavy drums]
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "suno-v4",
"prompt": "[Build-Up] [Drop: full energy, heavy drums]"
}
JSON%{model} is available through RunAPI as part of the unified model catalog. These prompts show practical input patterns that agents and backend services can reuse.
Copy any prompt and paste it into Claude Code, Codex, Cursor, or Windsurf after installing the RunAPI MCP Server. Developers can also copy the API example and send the prompt directly.
Browsing and copying prompt examples is free. Generation requests only cost money when you call a RunAPI model with your API key.
Yes. Treat each prompt as a starting point, then add your brand rules, output dimensions, safety constraints, and application-specific context before using it in production.