Skip to main content
POST
Python

Authorizations

Authorization
string
header
required

Body

multipart/form-data
audio_url
string
required

Input audio URL (supported format: YouTube URL).

Example:

"https://www.youtube.com/watch?v=example123"

audio_file
file

Audio file to upload and process.

stems
string
default:[]

JSON string list of required output stems. Available options: vocals, instrumental, male_vocal, female_vocal, lead_vocal, back_vocal, bass, drums, guitar, piano, keys, strings, winds, rhythm_guitar, solo_guitar, acoustic_guitar, electric_guitar, kick_drum, snare_drum, toms, hi_hat, ride, crash.

Example:

"[\"vocals\", \"drums\"]"

preprocessing_options
string
default:[]

JSON string list of preprocessing steps. Available options: Denoise, Deecho, Dereverb.

Example:

"[\"Denoise\", \"Dereverb\"]"

eco_mode
boolean
default:false

Enable eco mode for faster parallel extraction.

webhook_url
string

Callback URL for async processing.

Example:

"http://webhook.musicgpt.com"

Response

Successfully initiated audio extraction

success
boolean
task_id
string
conversion_id
string
eta
integer

Time in seconds to completion. -1 if unknown

credit_estimate
number<float>

Estimated credit cost