Vocal Separation API — Studio-Grade Stems in One REST Call

Why build on it

Quickstart

1. Sign in at /account, click Generate API key (looks like vsk_…), and top up credits. 2. Submit a job:

# Submit a separation job
curl -X POST https://aivoiceseparator.com/api/v1/separate \
  -H "X-API-Key: vsk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=VIDEO_ID", "output_format": "mp3"}'

# → {"job_id":"a1b2c3","status_url":".../api/v1/jobs/a1b2c3",
#    "cost_credits":1,"credit_balance":950}

3. Poll until state is done, then download the stems (download URLs are public + opaque, valid 24 h):

curl https://aivoiceseparator.com/api/v1/jobs/a1b2c3 \
  -H "X-API-Key: vsk_your_key_here"

# → {"job_id":"a1b2c3","state":"done","progress":100,"output_format":"mp3",
#    "stems":[
#      {"name":"vocals","url":".../api/download/a1b2c3/vocals"},
#      {"name":"instrumental","url":".../api/download/a1b2c3/instrumental"}]}

Python example

import requests, time

API = "https://aivoiceseparator.com"
H = {"X-API-Key": "vsk_your_key_here"}

job = requests.post(f"{API}/api/v1/separate", headers=H,
    json={"url": "https://youtu.be/VIDEO_ID", "output_format": "wav"}).json()

while True:
    s = requests.get(f"{API}/api/v1/jobs/{job['job_id']}", headers=H).json()
    if s["state"] in ("done", "error"): break
    time.sleep(5)

for stem in s["stems"]:                      # vocals + instrumental
    open(stem["name"]+".wav", "wb").write(requests.get(stem["url"]).content)

Endpoints

Returns { job_id, status_url, cost_credits, credit_balance }. Credits are charged on submit and refunded if the job fails.

Send your own file as multipart/form-data instead of a URL. Fields: file (required), output_format, transcribe. Same response and billing as above.

curl -X POST https://aivoiceseparator.com/api/v1/separate/upload \
  -H "X-API-Key: vsk_your_key_here" \
  -F "file=@song.mp3" \
  -F "output_format=wav"
# → {"job_id":"…","status_url":"…","cost_credits":1,"credit_balance":900}

Poll a job you own. state is one of queued · downloading · processing · done · error. When done, stems holds the download URLs; when error, error holds the reason.

Manage your key from the web (used by the /account page). Generate, view, or revoke.

Pricing

Prepaid credits, topped up on /account. No subscription, no monthly minimum, no per-seat fee. Failed jobs are refunded automatically.

Limits & errors

• Output: 2 stems — vocals and instrumental — Studio 3-model ensemble.
• Retention: input and output files are auto-deleted after 24 hours. Never used to train models.
• Processing: asynchronous — a 5-minute song completes in roughly 5–6 minutes on our RTX GPU.