Extract stems from a song

October 9, 2026 (October 18, 2026)

Table of contents

  1. Request Headers
  2. Request Body
  3. Responses
  4. Model
  5. Examples
  6. Try It

https://api.useapi.net/v1/mureka/music/stems

Split a song you generated into separate tracks, the same as Extract Stems on mureka.ai. Needs Mureka’s Premier plan. On Free or Pro every call returns 403 low vip level (6335).

There are two modes:

all_stems What you get Cost
true (default) All detected stems — up to 12 separate instrument and vocal tracks, plus MIDI 100 Mureka Gold
false Vocals + Instrumental 20 Mureka Gold

Each stem comes back as a .wav and an .mp3 link. Extraction takes about a minute for a 3-minute song (40 to 70 seconds in our tests).

Every call starts a new extraction and is charged again, even for a song you already extracted. Keep the stems_id of a finished extraction and use it with POST /music/stems-download instead of extracting the same song twice.

Once the job is completed, pass its stems_id to POST /music/stems-download for a single stem with its MIDI, ZIP archives of all stems and all MIDI, or a ready-made session for Ableton Live, Logic Pro, Pro Tools or Cubase. Those downloads are free.

POST /music/download with type stem still returns the basic stems package of a song, with no extraction job.

Request Headers 
Authorization: Bearer {API token}
Content-Type: application/json
# Alternatively you can use multipart/form-data
# Content-Type: multipart/form-data
Request Body 
{
    "song_id": "user:777-mureka:12345678901234-song:33445566",
    "all_stems": true
}
  • song_id is required.
    The song_id value returned by one of the following endpoints:

    The song’s own account runs the extraction, so there is no account parameter.

  • all_stems is optional (default: true).
    true extracts all detected stems, up to 12 tracks plus MIDI, for 100 Mureka Gold. The stems Mureka finds depend on the song. Names seen so far are bass, brass_and_winds, drums, guitar, other (shown as FX on mureka.ai), piano (Keyboard on mureka.ai), strings, synth and vocal.
    false extracts Vocals + Instrumental only, for 20 Mureka Gold. It returns two stems, instrumental and vocal, and both have MIDI.

  • async is optional, enables fire-and-forget mode (default: false). When true, returns immediately with 201 Created and job metadata. Poll GET /jobs/jobid for completion status.
    Without async the call waits for the extraction to finish and returns 200 with the completed job. If the extraction is still running after about 4 minutes, it returns 201 with the job still created — keep polling GET /jobs/jobid until it completes.
    A failed extraction returns the failed job, with its code as the HTTP status. A job still extracting after 10 minutes is marked failed.

  • replyUrl is optional, webhook URL for job status callbacks. Receives a POST request when the job ends as completed or failed. The JSON payload shape matches GET /jobs/jobid response.
    If no callback arrives within about 5 minutes, poll GET /jobs/jobid — an extraction that runs that long is finished by the poll, not by a callback.

  • replyRef is optional, custom reference string passed back in webhook callbacks. Useful for tracking jobs on your end.
Responses

  • 200 OK

    Extraction completed. Each stem has a .wav and an .mp3 link.

    Real response, ids shortened (a 3:15 song, 9 stems, 67 seconds).

    {
    "jobid": "j1010023903143042515m-u777-a12345678901234-bot:mureka",
    "verb": "music/stems",
    "jobType": "music",
    "status": "completed",
    "created": "2026-10-10T02:39:03.143Z",
    "request": {
        "song_id": 33445566,
        "all_stems": true,
        "account": "12345678901234"
    },
    "response": {
        "stems_id": "user:777-mureka:12345678901234-song:33445566-stems:55667788",
        "song_id": "user:777-mureka:12345678901234-song:33445566",
        "all_stems": true,
        "bpm": 120,
        "status": "completed",
        "generate_state": 1,
        "stems": [
            {
                "stem_name": "bass",
                "wav": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/bass.wav",
                "mp3": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/<id>.mp3"
            },
            {
                "stem_name": "brass_and_winds",
                "wav": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/brass_and_winds.wav",
                "mp3": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/<id>.mp3"
            },
            {
                "stem_name": "drums",
                "wav": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/drums.wav",
                "mp3": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/<id>.mp3"
            },
            {
                "stem_name": "guitar",
                "wav": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/guitar.wav",
                "mp3": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/<id>.mp3"
            },
            {
                "stem_name": "other",
                "wav": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/other.wav",
                "mp3": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/<id>.mp3"
            },
            {
                "stem_name": "piano",
                "wav": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/piano.wav",
                "mp3": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/<id>.mp3"
            },
            {
                "stem_name": "strings",
                "wav": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/strings.wav",
                "mp3": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/<id>.mp3"
            },
            {
                "stem_name": "synth",
                "wav": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/synth.wav",
                "mp3": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/<id>.mp3"
            },
            {
                "stem_name": "vocal",
                "wav": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/vocal.wav",
                "mp3": "https://static-cos.mureka.ai/cos-prod/song/audio/20261010/<id>/<id>.mp3"
            }
        ]
    },
    "updated": "2026-10-10T02:40:09.871Z"
}

  • 201 Created

    Job created in async mode (async: true), or a sync call that was still extracting after about 4 minutes. The extraction is processing in the background.

    Use GET /jobs/jobid to poll for completion status.

    {
    "jobid": "j1009123456789475905m-u777-a12345678901234-bot:mureka",
    "verb": "music/stems",
    "jobType": "music",
    "status": "created",
    "created": "2026-10-09T12:34:56.789Z",
    "request": {
        "song_id": 33445566,
        "all_stems": true,
        "async": true,
        "replyUrl": "https://your-domain.com/webhook",
        "replyRef": "my-custom-ref-123",
        "account": "12345678901234"
    },
    "response": {
        "stems_id": "user:777-mureka:12345678901234-song:33445566-stems:55667788",
        "song_id": "user:777-mureka:12345678901234-song:33445566",
        "all_stems": true,
        "status": "processing",
        "generate_state": 3
    }
}

  • 400 Bad Request

    {
  "error": "<Error message>",
  "code": 400
}

  • 401 Unauthorized

    {
  "error": "Wrong username/password combination.",
  "code": 401
}

  • 412 Precondition Failed

    The account does not have enough Mureka Gold for the extraction (100 for all stems, 20 for Vocals + Instrumental).

    {
  "error": "User balance is not enough to operate (6310)",
  "code": 412
}

  • 596 Account Error

    Returned when the account has an error state preventing API calls.

    {
    "error": "Session refresh failed 2026-01-19T14:31:15.000Z, manual update required",
    "code": "REFRESH_FAILED"
}

    Possible error codes:

    • ACCOUNT_ERROR - Account has a blocking error
    • REFRESH_FAILED - Automatic token refresh failed
    • REFRESH_IN_PROGRESS - Token refresh already in progress, retry shortly
    • SESSION_EXPIRED - Session expired and no auto-refresh available
    • COOKIE_EXPIRED - Google cookie has expired

    To resolve, update your account configuration via POST /accounts.

Model

  • Both sync and async calls return the job record. Structure matches GET /jobs/jobid response.

    {
    jobid: string                              // Job identifier
    verb: 'music/stems'                        // Job verb
    jobType: 'music'                           // Job type
    status: 'created' | 'completed' | 'failed'
    created: string                            // ISO 8601 timestamp
    updated?: string                           // ISO 8601 timestamp, once the job ends
    request: {
        song_id: number                        // Decoded Mureka id, not the user:…-song:… form
        all_stems: boolean
        account: string
        async?: boolean
        replyUrl?: string
        replyRef?: string
    }
    response?: {
        stems_id: string                       // Pass to POST /music/stems-download
        song_id: string
        all_stems?: boolean
        bpm?: number
        status: 'processing' | 'completed'
        generate_state?: number                // Mureka's own state: 3 while extracting, 1 when done
        stems?: {                              // Present when completed
            stem_name: string                  // e.g. vocal, drums, bass, other
            wav: string | null
            mp3: string | null
        }[]
    }
    error?: string                             // Present when failed
    code?: number                              // Present when failed
}

  • Error response structure (applies to both sync and async modes).

    {
    jobid?: string                             // Present for job-related errors
    error: string                              // Error summary message
    code?: number                              // HTTP status code or error code
    msg?: string                               // Additional error message
}
Examples 
  • curl -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer …" \
     -X POST https://api.useapi.net/v1/mureka/music/stems \
     -d '{"song_id": "…", "all_stems": true}'

  • const song_id = "user:777-mureka:12345678901234-song:33445566";
const all_stems = true;
const apiUrl = `https://api.useapi.net/v1/mureka/music/stems`; 
const api_token = "API token";
const data = { 
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${api_token}`,
    'Content-Type': 'application/json' }
};
data.body = JSON.stringify({ 
  song_id, all_stems
});
const response = await fetch(apiUrl, data);
const result = await response.json();
console.log("response", {response, result});

  • import requests
song_id = "user:777-mureka:12345678901234-song:33445566"
all_stems = True
apiUrl = f"https://api.useapi.net/v1/mureka/music/stems" 
api_token = "API token"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {api_token}"
}
body = {
    "song_id": song_id,
    "all_stems": all_stems
}
response = requests.post(apiUrl, headers=headers, json=body)
print(response, response.json())
Try It

Extraction takes about a minute for a 3-minute song (40 to 70 seconds in our tests).