Stem Separation API - v1

🚀 apiv2 is live!

Soundverse’s Enterprise API has moved to apiv2.soundverse.ai — new self-serve account setup, API keys, and billing are managed at platform.soundverse.ai. This page documents the legacy api.soundverse.ai API.

This endpoint allows users to separate audio stems from a provided track using AI.

Stem Separation API Overview

The Stem Separation API by Soundverse allows you to extract specific parts (or “stems”) of a song such as:

Vocals
Instruments
All individual stems (vocals, drums, bass, etc.)

This is useful for remixing, karaoke creation, music analysis, or background score extraction.

Core Parameters

🛈 The parameters below define the request body for this API.

Parameter	Type	Required?	Description
`audioUrl`	`string`	✅ Required	URL to the input audio file.

Request Body

Request body: 
{
  "audioUrl": "string"
}

Code Samples

Python code sample

Vocals
Instruments
All Stems

  import requests

  url = "https://api.soundverse.ai/v1/generate/stem-separation/vocals"
  headers = {
      "Authorization": "Bearer your_api_key_here",
      "Content-Type": "application/json"
  }
  payload = {
    "audioUrl": "string"
  }

  response = requests.post(url, json=payload, headers=headers)
  print(response.json())

  import requests

  url = "https://api.soundverse.ai/v1/generate/stem-separation/instruments"
  headers = {
      "Authorization": "Bearer your_api_key_here",
      "Content-Type": "application/json"
  }
  payload = {
    "audioUrl": "string"
  }

  response = requests.post(url, json=payload, headers=headers)
  print(response.json())

  import requests

  url = "https://api.soundverse.ai/v1/generate/stem-separation/all-stems"
  headers = {
      "Authorization": "Bearer your_api_key_here",
      "Content-Type": "application/json"
  }
  payload = {
    "audioUrl": "string"
  }

  response = requests.post(url, json=payload, headers=headers)
  print(response.json())

cURL

Vocals
Instruments
All Stems

    curl -X POST "https://api.soundverse.ai/v1/generate/stem-separation/vocals" \
    -H "Authorization: Bearer your_api_key_here" \
    -H "Content-Type: application/json" \
    -d '{
    "audioUrl": "string"
    }'

    curl -X POST "https://api.soundverse.ai/v1/generate/stem-separation/instruments" \
    -H "Authorization: Bearer your_api_key_here" \
    -H "Content-Type: application/json" \
    -d '{
    "audioUrl": "string"
    }'

    curl -X POST "https://api.soundverse.ai/v1/generate/stem-separation/all-stems" \
    -H "Authorization: Bearer your_api_key_here" \
    -H "Content-Type: application/json" \
    -d '{
    "audioUrl": "string"
    }'

Response

Vocals
Instruments
All Stems

[
  {
  "audioName": "vocals",
  "audioUrl": "str"
  }
]

  [
    {
      "audioName": "Guitar",
      "audioUrl": "str"
    },
    {
      "audioName": "Other",
      "audioUrl": "str"
    },
    {
      "audioName": "Drums",
      "audioUrl": "str"
    },
    {
      "audioName": "Bass",
      "audioUrl": "str"
    },
    {
      "audioName": "Piano",
      "audioUrl": "str",
    }
  ]

    [
      {
        "audioName": "vocals",
        "audioUrl": "str"
      },
      {
        "audioName": "Guitar",
        "audioUrl": "str"
      },
      {
        "audioName": "Other",
        "audioUrl": "str"
      },
      {
        "audioName": "Drums",
        "audioUrl": "str"
      },
      {
        "audioName": "Bass",
        "audioUrl": "str"
      },
      {
        "audioName": "Piano",
        "audioUrl": "str",
      }
    ]

Possible Errors

If NSFW words are detected

{
"success": False,
"message": "NSFW words detected. Please try again with a different prompt.",
}

If Artist name is detected

{
"success": False,
"message": "Artist name detected. Please try again with a different prompt.",
}

Generation Fail Error

{
"Detail": "str"
}

Get Started

Frequently Asked Questions

Creating with Soundverse

Exploring Soundverse

Account Management

Enterprise Platform

API Documentation

Stem Separation API - v1

🚀 apiv2 is live!

Stem Separation API Overview

Core Parameters

Request Body

Code Samples

Response

Possible Errors

🚀 apiv2 is live!

​Stem Separation API Overview

​Core Parameters

​Request Body

​Code Samples

​Response

​Possible Errors

Stem Separation API Overview

Core Parameters

Request Body

Code Samples

Response

Possible Errors