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.
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
- Which stems.
models: the default splits a song into six (vocals, drums, bass, guitar, piano, other)."orchestra"pulls out orchestral instruments by name, withinstrumentsto choose them;"detect"listens first and picks. - The drum kit, apart.
drum_splitreturns the kick, snare, hats and the rest as their own files. - The guitars, apart.
guitar_splitseparates two to four guitar parts. - The notes. Each stem's notes come back as MIDI by default;
include_midi: falseskips it, andstems_onlyis the fastest call. - A DAW session.
export:"logic"or"ableton"returns the stems laid out as a project.
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
- Separation is not perfect. In a dense mix a stem can carry a trace of another, most often cymbals in the vocals or a guitar in the piano.
- Asynchronous. Usually 60 s to 4 min, by the catalog.
- The notes are a transcription. A stem's MIDI is what a transcriber heard in it, most reliable on bass, piano and single-line instruments.
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.
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
- MIDI to audio APIyour notes, played
- Video soundtrack APIspot, render, lay on the picture
- Stem separation APIa mix in, stems and MIDI out
- Game music generatorseamless loops, in layers
- The MCP serverthe same jobs for an AI agent
- Every toolthe reference
- Planscredits a month