Skip to content

StemSplit/n8n-stemsplit

Repository files navigation

n8n-nodes-stemsplit

npm N8N Community Nodes License: MIT

Separate vocals, drums, bass, and other stems from any audio file — directly inside N8N. n8n-nodes-stemsplit connects your workflows to the StemSplit API, letting you remove vocals from a song, isolate instrumentals, extract drum tracks, or split full 6-stem mixes (vocals, drums, bass, guitar, piano, other) — without any ML infrastructure.

Submit audio via URL or binary upload, wait for processing, and get presigned download URLs for each stem — all as native N8N nodes.


What It Does

Accepts audio via public URL or binary file upload. Submits to the StemSplit API for processing. Returns presigned download URLs for each stem.

Operation When to use it
Separate Stems (Wait) You want vocals, drums, bass, etc. back immediately in the same workflow — submits and polls until complete
Separate Stems Fire-and-forget — submit many jobs in parallel and poll status later
Get Job Check status or retrieve output URLs for a previously submitted job
List Jobs Browse job history or filter by status (PENDING, PROCESSING, COMPLETED, FAILED)
Get Balance Check remaining credits before a batch run

Outputs presigned download URLs for: vocals · instrumental · drums · bass · piano · guitar · other


Installation

Via the N8N Community Nodes UI

  1. Open Settings → Community Nodes
  2. Click Install a community node
  3. Enter n8n-nodes-stemsplit
  4. Click Install

Via npm (self-hosted N8N)

npm install n8n-nodes-stemsplit

Credentials

  1. Go to stemsplit.io/app/settings/api and generate an API key (format: sk_live_...).
  2. In N8N, add a new StemSplit API credential and paste your key.

The node sends Authorization: Bearer <key> on every request to https://stemsplit.io/api/v1.


Operations

Separate Stems

Submits audio for processing and returns immediately with a job ID. Use this when you want to submit many jobs in parallel and poll status later with Get Job.

Input source:

  • Binary File — pass audio as a binary N8N item (from an HTTP Request, Read Binary File, or any binary-capable node)
  • URL — provide a publicly accessible URL; StemSplit fetches it server-side

Parameters:

Parameter Default Description
Output Type VOCALS + Instrumental Which stems to extract (see Output Types below)
Quality Best Processing quality: Fast, Balanced, or Best
Output Format MP3 Output file format: MP3, WAV, or FLAC
File Name (auto) Override the job's display name
Metadata {} Custom JSON echoed back in all job responses

Output fields: id, status, progress, creditsRequired, estimatedSeconds, createdAt, options, input, metadata


Separate Stems (Wait for Completion)

Submits audio and polls until the job reaches COMPLETED — or throws on FAILED or timeout. Returns presigned download URLs for every stem.

Additional parameters:

Parameter Default Description
Timeout (Seconds) 600 Give up after this many seconds
Poll Interval (Seconds) 5 How often to check job status

Additional output fields:

  • vocalsUrl / vocalsExpiresAt
  • instrumentalUrl / instrumentalExpiresAt
  • drumsUrl, bassUrl, otherUrl, pianoUrl, guitarUrl (when applicable)

Note: Presigned URLs expire 1 hour after job completion. Output files are deleted 14 days after creation.


Get Job

Fetch a single job by ID. Returns the same fields as Separate Stems (Wait), including all available output URLs.


List Jobs

Returns a paginated list of jobs. Optional status filter (PENDING, PROCESSING, COMPLETED, FAILED) and pagination via limit/offset.


Get Balance

Returns your current credit balance:

{
  "balanceSeconds": 3600,
  "balanceMinutes": 60,
  "balanceFormatted": "60 minutes",
  "updatedAt": "2026-05-21T00:00:00Z"
}

Credit model: 1 credit = 1 second of audio. Credits are deducted at job submission. If your balance is insufficient, the node throws a 402 INSUFFICIENT_CREDITS error.


Output Types

Value Stems produced
VOCALS Vocals only
INSTRUMENTAL Instrumental only
BOTH Vocals + Instrumental
FOUR_STEMS Vocals, Drums, Bass, Other
SIX_STEMS Vocals, Drums, Bass, Other, Piano, Guitar (requires Best quality)

Supported Audio Formats

Input: mp3, wav, flac, m4a, ogg, webm, aac, wma
Max file size: 50 MB


Example Workflows

Basic n8n vocal remover pipeline

[HTTP Request: download audio]
  → [StemSplit: Separate Stems (Wait)]
  → [HTTP Request: download vocals URL]
  → [Write Binary File: save vocals.mp3]

Batch stem splitter from local files

[Read Binary File: song.mp3]
  → [StemSplit: Separate Stems (Wait), Output: SIX_STEMS]
  → [Split In Batches]
  → [HTTP Request: upload each stem to S3]

Fire-and-forget with webhook callback

[Webhook trigger]
  → [StemSplit: Separate Stems]      ← returns job ID instantly
  → [Set: store job ID in DB]
  → [Cron: poll every 30s via Get Job]
  → [IF: status === COMPLETED]
  → [HTTP Request: notify downstream service]

Why StemSplit?

StemSplit runs state-of-the-art source separation models (HTDemucs and similar) on GPU infrastructure purpose-built for audio. If you need to separate vocals online without managing your own ML stack, StemSplit's API gives you:

  • Sub-minute turnaround on most tracks (Fast/Balanced quality)
  • High-fidelity six-stem output — vocals, drums, bass, piano, guitar, other
  • Simple credit model — pay per second of audio processed, no subscriptions required
  • No file hosting needed — pass a URL and StemSplit fetches it server-side

Full API docs: stemsplit.io/docs/api
OpenAPI spec: GET https://stemsplit.io/api/v1/openapi


Requirements

  • N8N v0.200 or later
  • A StemSplit account with an API key — sign up at stemsplit.io
  • Sufficient credit balance for your audio files (check with Get Balance)

License

MIT © StemSplit