---
name: separate-stems
description: Split a song into vocals, drums, bass, and up to 16 fine-grained instrument stems.
license: MIT
---

# Skill: separate-stems

Split any song into isolated stems — vocals, drums, bass, guitar, piano,
or up to 16 fine-grained categories — for remixing, karaoke, or sampling.

## When to use

Invoke when the user wants to:

- Remove vocals from a song (karaoke / instrumental track)
- Isolate a specific instrument (acapella, drum loop, bass-only)
- Remix or sample a track legally without a multitrack stem pack
- Build a karaoke file with an instrumental + lyric overlay

## API

`POST https://api.audiopod.ai/api/v1/stems/separate`

Headers:

- `Authorization: Bearer <access_token>`
- `Content-Type: multipart/form-data`

Body (form-data):

- `file`: audio file (MP3, WAV, FLAC, OGG; up to 500 MB)
- `model`: `htdemucs` | `htdemucs_ft` | `htdemucs_6s` (4-stem vs 6-stem)
- `output_format`: `wav` | `mp3` | `flac`

## Response

```json
{ "job_id": "uuid", "status": "PENDING" }
```

Poll `GET /api/v1/stems/jobs/{job_id}` for the per-stem download URLs.

## Notes

- Free tier: up to 5 minutes/song; paid tiers up to 30 minutes/song
- Stems are royalty-free for personal and commercial use on paid plans