mashup

POST

https://api.musicapi.ai/api/v1/sonic/mashup

Mix two existing songs together to create a new song. This endpoint combines elements from two source clips to generate a unique mashup.

Credits cost: 15 (older models) / 20 (newer models) — older = sonic-v3-5, sonic-v4; newer = sonic-v4-5, sonic-v4-5-plus, sonic-v5, sonic-v5-5.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Mashup with custom lyricsMashup with AI-generated lyricsInstrumental mashup

{
    "mashup_clip_ids": [
        "abc123-def456",
        "xyz789-ghi012"
    ],
    "custom_mode": true,
    "mv": "chirp-v4-5-plus",
    "prompt": "[Verse 1]\nMixing beats together\nCreating something new\n\n[Chorus]\nThis is our mashup\nBlending old and new",
    "title": "Epic Mashup",
    "tags": "electronic, dance, energetic",
    "style_weight": 0.7
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Mashup with custom lyricsMashup with AI-generated lyricsInstrumental mashup

curl --location 'https://api.musicapi.ai/api/v1/sonic/mashup' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "mashup_clip_ids": [
        "abc123-def456",
        "xyz789-ghi012"
    ],
    "custom_mode": true,
    "mv": "chirp-v4-5-plus",
    "prompt": "[Verse 1]\nMixing beats together\nCreating something new\n\n[Chorus]\nThis is our mashup\nBlending old and new",
    "title": "Epic Mashup",
    "tags": "electronic, dance, energetic",
    "style_weight": 0.7
}'

Responses

🟢200success

application/json

success

Bodyapplication/json

Example

{
    "code": 200,
    "message": "success",
    "task_id": "81ed9f60-56ae-48c1-9c46-33a8220dfca7"
}

Modified at 2026-07-31 11:25:38

sample

get BPM