§ Music API · Stem separation

Stem separation API

Published November 2026

Send a song over HTTP and get its vocals, drums, bass, guitar, piano and the rest back as separate WAVs, with each stem's notes as MIDI.

Get an API key →OpenAPI 3.1The job catalog

A free account has 120 credits a month. The catalog, a quote and the OpenAPI document need no key.

One call

Make a key at Settings → API keys and send it as X-API-Key (or Authorization: Bearer):

export DOO_API_KEY=dsk_live_...

separate_stems takes a recording at a public URL:

curl -s -X POST https://api.doseedo.com/api/jobs \
  -H "X-API-Key: $DOO_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: song-stems-v1' \
  -d '{
  "kind": "separate_stems",
  "input": { "audio_url": "https://example.com/song.wav" }
}'
curl -s "https://api.doseedo.com/api/jobs/$JOB_ID?wait=50" -H "X-API-Key: $DOO_API_KEY"

The finished job's output.stems maps each stem's name to its WAV, and output.midi maps a stem to its notes:

{
  "object": "job",
  "kind": "separate_stems",
  "status": "succeeded",
  "output": {
    "stems": {
      "vocals": "https://api.doseedo.com/api/files/…/song_vocals.wav",
      "drums": "…/song_drums.wav",
      "bass": "…/song_bass.wav",
      "guitar": "…/song_guitar.wav",
      "piano": "…/song_piano.wav",
      "other": "…/song_other.wav"
    },
    "midi": { "bass": "…/song_bass.mid", "piano": "…/song_piano.mid" }
  }
}

Only the stems the recording contains come back. Run on November 16, 2026 against a 42-second instrumental: its stems and their MIDI came back 50 seconds after the submit, for 20 credits. Result links are pre-signed: download them with a plain GET and no header. They last 24 hours, and a result link is accepted as the audio_url of a later job.

A file on your machine

A file that is not at a public URL goes up in two calls, and its key is passed as audio_key:

# 1. Ask for an upload slot
curl -s -X POST https://api.doseedo.com/api/jobs/uploads \
  -H "X-API-Key: $DOO_API_KEY" -H 'Content-Type: application/json' \
  -d '{"filename":"song.wav"}'
# → { "key": "ingest/…", "upload_url": "https://…", "headers": { "Content-Type": "audio/wav" }, "input_param": "audio_key" }

# 2. PUT the bytes to upload_url, with that Content-Type
curl -s -X PUT -H 'Content-Type: audio/wav' --data-binary @song.wav "$UPLOAD_URL"

# 3. Pass the key to the job as input.audio_key
curl -s -X POST https://api.doseedo.com/api/jobs \
  -H "X-API-Key: $DOO_API_KEY" -H 'Content-Type: application/json' \
  -d '{"kind":"separate_stems","input":{"audio_key":"ingest/…"}}'

WAV, MP3, FLAC, AIFF, M4A, OGG or Opus.

What your code controls

What it costs

20 credits a recording for the six-stem split. The orchestral split costs by how many instruments it extracts, up to 80 credits. Stems are never held back on a free account.

One credit pool pays for every job. A free account has 120 credits a month; Pro is $12 a month with 2,000, plus one-time extra usage (500 credits for $5). The quote endpoint prices a call before you make it, a refused call spends nothing, and a failed job is refunded.

Limits

§ Same job, any name

A stem separation API

Stem separation API, vocal remover API, audio source separation API and stem splitter API name the same job: a mixed recording goes in, and its parts come out as separate files.

InA song or any mixed recording: a public URL or an upload.
OutOne WAV per stem (vocals, drums, bass, guitar, piano, other; or orchestral instruments), and the notes of each as MIDI.
Also searched asstem separation api · vocal remover api · audio source separation api · stem splitter api · audio separation api · instrument separation api · vocal isolation api · drum separation api · stems and midi api · music source separation api

Separate your first song

Make a key and post a URL. A free account has 120 credits a month, enough for six songs.

Get an API key →

FAQ

Is there an API for stem separation?

Yes. Doseedo's separate_stems job takes a recording by URL or upload and returns its stems as separate WAV files, with each stem's notes as MIDI.

Which stems does it return?

By default up to six: vocals, drums, bass, guitar, piano and other, whichever the recording contains. An orchestral model separates instruments such as violin, cello, trumpet or flute by name, and the drum kit and the guitars can be split further.

Is there a free stem separation API?

A free Doseedo account has 120 credits a month and a six-stem separation is 20, so six songs a month are free. Stems are the same on every plan.

Can it remove vocals?

Yes. The vocals stem is the voice alone, and the other stems together are the instrumental.

Does it return MIDI?

Yes. Each pitched stem comes back with its notes as a MIDI file, and the drum stem with its hits.

The music API · music your code controls

By job
For games
Also

Related