Check a stem split

November 21, 2026

Table of contents

  1. Request Headers
  2. Path Parameters
  3. Status Values
  4. Responses
  5. Model
  6. Examples
  7. Try It

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}
Path Parameters
  • stemsItemId is required. The stemsItemId returned by a previous POST music/stems-splitter request. It names the account that holds the split, so no user_id is 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
  • 200 OK

    Every state answers 200: check status_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"
    }
    
  • 400 Bad Request

    {
      "error": "Path parameter stemsItemId (abcdef123456789) has incorrect format",
      "code": 400
    }
    
  • 401 Unauthorized

    {
      "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_id use 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_id returns 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"))
    
Try It