MusicAPI
HomeDocs
HomeDocs
  1. riffusion
  • Introduction
  • Credits Usage Guide
  • Music API FAQ & Troubleshooting
  • Special Scenarios
  • Error handling
  • sonic
    • Sonic Instructions
    • create music
      POST
    • extend music
      POST
    • concat music
      POST
    • cover music
      POST
    • stems basic
      POST
    • stems full
      POST
    • create persona
      POST
    • create music with persona
      POST
    • upload music
      POST
    • get wav
      POST
    • get music
      GET
  • riffusion
    • Riffusion instructions
    • create music (with lyrics)
      POST
    • create music (with description)
      POST
    • cover music
      POST
    • extend music
      POST
    • replace music section
      POST
    • swap music sound
      POST
    • swap music vocals
      POST
    • upload
      POST
    • get music
      GET
  • studio(Unavailable)
    • Studio Instructions
    • description mode (Use case1)
    • extend mode (Use case2)
    • custom mode (Use case3)
    • instrumental mode (Use case4)
    • get music
  • lyrics generation
    • Make Lyrics
  • nuro
    • Nuro Instruction
    • Error handling
    • create vocal music
    • create instrument music
    • get music
  • get-credits
    GET
  1. riffusion

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

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",
    "vocal_variation": 1,
    "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 Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
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",
    "vocal_variation": 1,
    "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

Example
{
    "message": "success",
    "task_id": "6d7253ac-916e-49a8-b288-91ffa7f8a8cd"
}
Modified at 2025-07-22 19:48:37
Previous
swap music sound
Next
upload
Built with