Check a stem split
November 21, 2026
Table of contents
This endpoint reads the state of a stem split started with POST music/stems-splitter, with one read of TemPolor’s split status. Use it after async=true, or when the split was still processing when that request answered. Read it every 10 seconds or so until status_name is COMPLETED, then download the stems ZIP from stemsZipUrl.
https://api.useapi.net/v1/tempolor/music/stems-splitter/
stemsItemId
Request Headers
Authorization: Bearer {API token}
API tokenis required, see Setup useapi.net for details.
Path Parameters
stemsItemIdis required. ThestemsItemIdreturned by a previous POST music/stems-splitter request. It names the account that holds the split, so nouser_idis needed.
Status Values
| state | status_name | Description |
|---|---|---|
| 2 | COMPLETED | The split is done and stemsZipUrl links to the stems ZIP |
| 3 | FAILED | TemPolor could not split this audio, error says so: send it again or try another file |
| 4 | FAILED | Rejected by TemPolor content moderation, error says so |
| -1 | EXPIRED | The split has expired at TemPolor, error says so: send the audio again |
| any other | PROCESSING | TemPolor is still splitting the audio |
Responses
-
Every state answers
200: checkstatus_name. A finished split:{ "state": 2, "title": "audio_file.mp3", "stemsZipUrl": "https://example.com/path/to/stems.zip", "itemId": "abcdef123456789", "stemsItemId": "user:12345-tempolor:user_id-stems:abcdef123456789", "status_name": "COMPLETED" }A split that failed:
{ "state": 3, "title": "audio_file.mp3", "itemId": "abcdef123456789", "stemsItemId": "user:12345-tempolor:user_id-stems:abcdef123456789", "status_name": "FAILED", "error": "TemPolor could not split this audio (state 3): send it again or try another file" } -
{ "error": "Path parameter stemsItemId (abcdef123456789) has incorrect format", "code": 400 } -
{ "error": "Unauthorized", "code": 401 } -
596 Account signed out
TemPolor signed the account out, so its session ticket no longer works. The API stops using the account until you add it again with fresh credentials at POST accounts, see Setup TemPolor. Requests without
user_iduse your other accounts in the meantime.{ "error": "TemPolor signed out account 101441809 (You are currently logged out (400006)). Add it again with POST /v1/tempolor/accounts using fresh credentials, see https://useapi.net/docs/start-here/setup-tempolor", "code": 596 }If every account you have is in this state, a request without
user_idreturns 596 as well.
Model
The split’s state from TemPolor with its status_name, and stemsZipUrl once it is COMPLETED.
The stem split, field by field
{ // TypeScript, all fields are optional
state: number // 2 done, 3 failed, 4 refused by content moderation, -1 expired, anything else still splitting
title: string
detail: string[]
stemsZipUrl: string // URL to download the zip with separated stems, once state is 2
audioType: string
itemId: string
stemsItemId: string
status_name: string // "COMPLETED", "PROCESSING", "FAILED", "EXPIRED"
error: string // FAILED and EXPIRED only
code: number
}
Examples
-
curl -H "Authorization: Bearer …" \ "https://api.useapi.net/v1/tempolor/music/stems-splitter/user:12345-tempolor:user_id-stems:abcdef123456789" -
const token = "API token"; const stemsItemId = "user:12345-tempolor:user_id-stems:abcdef123456789"; const apiUrl = `https://api.useapi.net/v1/tempolor/music/stems-splitter/${stemsItemId}`; let result; do { const response = await fetch(apiUrl, { headers: { "Authorization": `Bearer ${token}` } }); result = await response.json(); console.log(response.status, result.status_name); if (!response.ok || result.status_name !== "PROCESSING") break; await new Promise(resolve => setTimeout(resolve, 10000)); } while (true); console.log("stems ZIP", result.stemsZipUrl); -
import requests import time token = "API token" stems_item_id = "user:12345-tempolor:user_id-stems:abcdef123456789" apiUrl = f"https://api.useapi.net/v1/tempolor/music/stems-splitter/{stems_item_id}" headers = {"Authorization": f"Bearer {token}"} while True: response = requests.get(apiUrl, headers=headers) result = response.json() print(response.status_code, result.get("status_name")) if response.status_code != 200 or result.get("status_name") != "PROCESSING": break time.sleep(10) print("stems ZIP", result.get("stemsZipUrl"))