Sign in
latestOpenAPI 3.1.02026-08-12154749.3 KB

ebb545e26e94

Stem Separation

Split a file into stems using the stem separator presets

Result of /check/ includes 2 tracks:
- stem:{"type":"stem", "label":"<stem_name>", "url":"..."}
- without stem:{"type":"back", "label":"no_<stem_name>", "url":"..."}

LEAD_BACK VOCALS:
For 'vocals' stem you can use parameter multivocal="lead_back" and receive both lead and backing vocals as separate stems.
Result of /check/ includes 4 tracks. Backing vocals track is optional and could be suppressed if not found in the audio:
lead vocals:{"type":"stem", "label":"vocals@0", "url":"..."}
backing vocals:{"type":"stem", "label":"vocals@1", "url":"..."}
instrumental:{"type":"back", "label":"no_vocals", "url":"..."}
instrumental + backing vocals:{"type":"back", "label":"mix_no_lead", "url":"..."}
post/api/v1/split/stem_separator/

Request body

source_idstring uuid4 required

ID of the source file to be processed.

idempotency_keystring uuid4 nullable

Unique uuid4 key to ensure idempotent requests.

Prevents duplicate task execution with the same parameters.

Can be reused until the task starts. Once processing begins, reusing this key will return an error.

Example request

{
  "source_id": "2fe8f214-1771-4900-9e7e-570f823bd359",
  "presets": {
    "stem": "vocals"
  }
}

Response

OK

task_idstring required

ID of the created split task.

Example response

{
  "task_id": "e1fc1d8f-502e-4de0-bf3b-b30543d11c77"
}