Skip to main content
POST
/
suno
/
v2
/
mashupLyrics
Mashup Lyrics
curl --request POST \
  --url https://api.mountsea.ai/suno/v2/mashupLyrics \
  --header 'Content-Type: application/json' \
  --data '
{
  "lyrics_a": "<string>",
  "lyrics_b": "<string>"
}
'
{
  "taskId": "<string>"
}
Generate mashup lyrics by combining lyrics from two songs. Use [Instrumental] for instrumental tracks. After generating mashup lyrics, use Generate with task=mashup to create the music.

​
Request Body

​
lyrics_a
string
required
Lyrics of the first song. Use [Instrumental] if the track is instrumental.
​
lyrics_b
string
required
Lyrics of the second song. Use [Instrumental] if the track is instrumental.

​
Response

​
taskId
string
The task ID. Use this to query task status via Get Task Status.

​
Example

curl -X POST https://api.mountsea.ai/suno/v2/mashupLyrics \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "lyrics_a": "[Verse 1]\nWalking down the street today\nSunshine lighting up my way\n\n[Chorus]\nFeeling so alive, feeling so free",
    "lyrics_b": "[Instrumental]"
  }'

​
Response Example

{
  "taskId": "15c257ff-43f7-4678-bd41-202ad6b8488b"
}

​
Workflow

1

Generate Mashup Lyrics

Call this endpoint with lyrics from two songs to generate combined mashup lyrics.
2

Check Task Status

Poll the Task Status endpoint with the returned taskId to get the generated mashup lyrics.
3

Generate Mashup Music

Use the mashup lyrics with the Generate endpoint (task=mashup) to create the final mashup track.
Use [Instrumental] as the lyrics value when one of the tracks doesn’t have vocals. This is useful when creating mashups between a vocal track and an instrumental track.