swap music vocals

POST

https://api.musicapi.ai/api/v1/riffusion/create

Reference documentation: https://www.riffusion.com/docs/create/stem-swaps, Describe the changes to the vocals in the sound field, support self-uploaded songs

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

custom_mode

boolean

required

Enable custom mode (set to true to use lyrics-based generation).

lyrics

string

required

Lyrics to generate the song (only applicable when custom_mode is true).

title

string

optional

Title of the song (optional metadata).(only applicable when custom_mode is true)

sound

string

required

Style and sound details. Specify genre, vocal tone, etc.(only applicable when custom_mode is true)

continue_clip_id

string

required

The clip id of the original song you want to swap vocals, you can use uploaded clip id

task_type

enum<string>

required

Task type, can be create_music, extend_music, cover_music, extend_upload_music, replace_music,replace_upload_music，swap_music_sound,swap_upload_music_sound，swap_music_vocals,swap_upload_music_vocals; if use uploaded clip id, make sure use upload task type

Allowed values:

create_musicextend_musiccover_musicextend_upload_musiccover_upload_musicreplace_musicswap_music_soundswap_music_vocalsreplace_upload_musicswap_upload_music_soundswap_upload_music_vocals

enum<string>

required

Model version. Options: "FUZZ-1.1 Pro", "FUZZ-1.1", "FUZZ-1.0 Pro", "FUZZ-1.0"

Allowed values:

FUZZ-1.1 ProFUZZ-1.0 ProFUZZ-1.1FUZZ-1.0

Example

{
    "custom_mode": true,
    "lyrics": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
    "title": "Starts",
    "sound": "dream pop+etherial vibes+female-vocalist",
    "continue_clip_id": "f524dd12-cb7a-4eb6-b2fb-780f0ed07d9c",
    "task_type":"swap_music_vocals",
    "mv": "FUZZ-1.1 Pro"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.musicapi.ai/api/v1/riffusion/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "custom_mode": true,
    "lyrics": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
    "title": "Starts",
    "sound": "dream pop+etherial vibes+female-vocalist",
    "continue_clip_id": "f524dd12-cb7a-4eb6-b2fb-780f0ed07d9c",
    "task_type":"swap_music_vocals",
    "mv": "FUZZ-1.1 Pro"
}'

Responses

🟢200success

application/json

Body

message

string

required

task_id

string

required

Example

{
    "message": "success",
    "task_id": "6d7253ac-916e-49a8-b288-91ffa7f8a8cd"
}

Modified at 2025-06-26 18:49:51

swap music sound

upload