Description
AIStemSplitter n8n Community Node
n8n community node for AIStemSplitter — submit an
audio URL, separate it into vocals, drums, bass and other stems, and read the
result inside your n8n workflow.
Published on npm as
@aistemsplitter/n8n-nodes-aistemsplitter.
Operations
| Operation | Description |
| — | — |
| Create Split | Submit an audio URL to the AIStemSplitter API and start a new stem-splitting job. Returns the job id and queued status. |
| Get Split | Look up an existing split job by id and read its status and stem output URLs. |
| Get Credits | Return the remaining credit balance on the associated AIStemSplitter account. |
Install
This node is a verified n8n community node.
Self-hosted n8n
1. Open Settings → Community Nodes in your n8n instance.
2. Click Install and enter:
@aistemsplitter/n8n-nodes-aistemsplitter
3. Accept the community-node risk prompt and click Install.
4. Refresh the workflow editor — the AIStemSplitter node appears under
the Transform category in the node picker.
n8n Cloud
Open Settings → Community Nodes → Install and follow the same flow with
the package name above.
Get an AIStemSplitter API key
1. Create an account at aistemsplitter.org.
2. Open
aistemsplitter.org/settings/developer.
3. Click Create API key and copy the value (it starts with ast_).
4. Treat the key as a secret — anyone with the key can spend your credits.
Configure the AIStemSplitter API credential
1. In n8n, open Credentials → New and search for AIStemSplitter API.
2. Fill in the fields:
– API Key — paste the ast_… key from the previous section.
– API Base URL — leave the default https://api.aistemsplitter.org/v1
unless you are pointed at a custom environment.
3. Click Save. n8n will run the built-in GET /credits test against the
API to confirm the key works.
Example: split a song from a URL
The smallest useful workflow has three nodes — a manual trigger, the
AIStemSplitter node configured for Create Split, and a second
AIStemSplitter node configured for Get Split to poll the job.
1. Add a Manual Trigger (or any other trigger).
2. Add an AIStemSplitter node:
– Credential: AIStemSplitter API (set up above).
– Operation: Create Split.
– Audio URL: a public URL to your audio file, e.g.
https://example.com/song.mp3.
– Stem Model: 6 Stems (Adds Guitar + Piano) for the highest detail,
or 4 Stems for the classic Vocals/Drums/Bass/Other split.
3. Add a second AIStemSplitter node:
– Operation: Get Split.
– Split ID: {{$json.id}} — references the id returned by the
Create Split node.
4. (Optional) Wrap Get Split in a Wait + loop until status === 'succeeded'
if you need to block on the result. Splits typically finish in a few
seconds for short clips.
5. Use the stems field on the Get Split output to download the resulting
audio (vocals, drums, bass, guitar, piano, other) and pass it into the next
step of your workflow (Dropbox upload, Slack notification, etc.).
Error handling
API failures (4xx/5xx responses, network errors, missing credits) raise an
NodeApiError, so HTTP status and the upstream error message surface in the
n8n UI. Enable Continue On Fail on the node to push an { error } item
into the output instead of stopping the workflow — useful when batch-processing
many URLs.
Compatibility
- Node.js 22 or newer
- n8n 1.42 or newer (any version that supports
- AIStemSplitter site: aistemsplitter.org
- API reference: aistemsplitter.org/developers/api
- API base URL:
https://api.aistemsplitter.org/v1 - Issues:
Resources
License
MIT
