通过 RunAPI 使用 suno-v4 的示例。复制 prompt 后，可在 Claude Code、Codex、Cursor、Windsurf 或后端 API 中使用。
1. claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
2. 重启 Claude Code
3. 粘贴这个 prompt：生成音乐："Indie folk, 92 BPM, melancholic, fingerstyle acoustic guitar, whispered vocals, 2010s indie style"1. codex plugin install runapi-mcp@agents
2. 重启 Codex
3. 粘贴这个 prompt：生成音乐："Indie folk, 92 BPM, melancholic, fingerstyle acoustic guitar, whispered vocals, 2010s indie style"1. npx @runapi.ai/mcp init cursor
2. 重启 Cursor
3. 粘贴这个 prompt：生成音乐："Indie folk, 92 BPM, melancholic, fingerstyle acoustic guitar, whispered vocals, 2010s indie style"1. npx @runapi.ai/mcp init windsurf
2. 重启 Windsurf
3. 粘贴这个 prompt：生成音乐："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} 是 RunAPI 统一模型目录中的模型。这些 prompts 展示了 agent 和后端服务可以复用的实际输入模式。
安装 RunAPI MCP Server 后，复制任意 prompt 并粘贴到 Claude Code、Codex、Cursor 或 Windsurf。开发者也可以复制 API 示例直接调用。
浏览和复制 prompt 示例是免费的。只有当你使用 API key 调用 RunAPI 模型生成内容时，才会产生费用。
可以。把每个 prompt 当作起点，再补充品牌规则、输出尺寸、安全约束和你的业务上下文。