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:
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
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/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 -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/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
[
{
"audioName": "vocals",
"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",
}
]
[
{
"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.",
}
