Skip to main content
POST
Stem preset (free in November)

Authorizations

Authorization
string
header
required

Body

multipart/form-data
audio_url
string
required

Input audio URL (supported format: YouTube URL).

audio_file
file

Audio file to upload and process.

stem_preset
enum<string>

Quick preset instead of stems. 2_stems: vocals, instrumental. 6_stems: vocals, instrumental, piano, bass, drums, guitar. Do not send with a non-empty stems list. Free on paid plans during November 2026 (UTC), up to 20 stems per clock hour and 100 stems per day; each preset uses one slot per stem (2 or 6).

Available options:
2_stems,
6_stems
Example:

"6_stems"

stems
string
default:[]

JSON string list of required output stems. Required unless stem_preset is sent. 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 stem extraction

success
boolean
task_id
string
conversion_id
string
eta
integer
credit_estimate
number
message
string
status
string
is_free_promo
boolean

True when this extraction is free under an active promotion. credit_estimate is then 0.0 and no credits are charged.

free_generations_remaining_hour
integer | null

Free stems left in the current UTC clock hour, or null when no promotion applies.

free_generations_remaining_day
integer | null

Free stems left today (UTC), or null when no promotion applies.

free_quota_resets_at
string<date-time> | null

UTC time when more free stems become available, or null when no promotion applies.