Skip to main content
POST
/
convert-voice
Convert Voice
curl --request POST \
  --url https://api.musicfy.lol/v1/convert-voice \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form 'file_url=<string>' \
  --form pitch_shift=0 \
  --form formant_shift=1.0 \
  --form isolate_vocals=false \
  --form background_pitch_shift=0 \
  --form background_formant_shift=1.0 \
  --form 'voice_id=<string>'
[
  [
    {
      "file_url": "https://audio.musicfy.lol/file_id",
      "type": "vocals"
    },
    {
      "file_url": "https://audio.musicfy.lol/file_id",
      "type": "instrumental"
    },
    {
      "file_url": "https://audio.musicfy.lol/file_id",
      "type": "combined"
    }
  ]
]

Body

multipart/form-data
​
file
file

Audio file to convert.

​
file_url
string<url>

URL to the audio file. Must be provided if file is not provided. Must be publicly accessible.

​
pitch_shift
integer<int32>
default:0

Pitch shift of the vocals. Range between -12 and 12. Defaults to 0.

​
formant_shift
number<float>
default:1.0

Formant shift of the vocals. Range between 0.1 and 2.0. Defaults to 1.0.

​
isolate_vocals
boolean
default:false

Whether to isolate the vocals and remove the background music.

​
background_pitch_shift
integer<int32>
default:0

Pitch shift of the background music. Only applies if isolate_vocals is true. Range between -12 and 12.

​
background_formant_shift
number<float>
default:1.0

Formant shift of the background music. Only applies if isolate_vocals is true. Range between 0.1 and 2.0

​
voice_id
string

ID of the voice to use for conversion.

Response

200 - application/json

Successful Response

​
file_url
string
Example:

"https://audio.musicfy.lol/file_id"

​
type
string
Example:

"vocals"