Suno Mashup API

What is Suno Mashup?#

Suno Mashup is an endpoint that combines two songs you already made with Suno into one new track. It works on clips, not on uploaded files: you first run a Suno generation (music, extend, cover, and so on), take two clip IDs from the finished tasks, and send them to suno-ai/mashup in a clip_ids array. The model listens to both and writes a fresh song that carries parts of each. You choose the model version with mv, and you can push the result toward a genre with tags, give it new lyrics through prompt, name it with title, drop vocals with make_instrumental, or rule out styles with negative_tags. The task returns two new clips, the same shape as a normal music generation, and both source clips stay as they were.

Key features of Suno Mashup#

Four things define how the mashup call behaves.

Exactly two source clips

clip_ids takes two Suno clip IDs, no more and no fewer. That fixed shape makes the call easy to wire into a "pick two songs" UI, and the output is a real blend of both tracks.

Steer the blend with tags and lyrics

Add tags such as "lofi piano, late night" to set the style of the new song, and negative_tags to keep unwanted genres out. Pass prompt with your own lyrics if the mashup should sing something new.

Three v6 model versions

Set mv to chirp-hawk for the default v6 model, chirp-hawk-wild for more unpredictable results, or chirp-goose for the faster v6 Mini.

Two new clips per request

Like music generation, every mashup task returns a pair of clips. You get two takes on the blend to choose from, and each new clip has its own ID for further edits.

Best for#

Use cases#

A music app can let users tick two songs from their library and press "Mash up", sending both clip IDs plus a style field to the endpoint and showing the two results side by side. A playlist tool can blend the opening and closing tracks of a set into a transition song. A content studio running batch generations can pair the strongest two drafts for each brief and mash them as a second pass. If you need a looser link between songs, the Suno Inspiration API takes one to four references instead, and source clips for either call come from Suno music generation.

API examples#

Full parameters for mashup, inspiration, and sample are in the Suno remix docs.

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "suno-ai/mashup",
    "input": {
      "mv": "chirp-hawk",
      "clip_ids": [
        "1901ec96-72c6-4c26-8e56-91028ca6070d",
        "5a6bb955-1536-4f43-877a-b4aa9fb18a4e"
      ],
      "tags": "lofi piano, late night"
    }
  }'

The response carries a task_id. Poll GET /v1/tasks/<task_id> until the two new clips are ready, or add a callback_url next to input to receive the result as a webhook.