Check a voice clone

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 voice clone started with POST music/cloned-voices, with one read of TemPolor’s clone status. Use it after async=true, or when the clone was still processing when that request answered: TemPolor lists a voice in GET music/cloned-voices only once it is ready. Read it every 10 seconds or so until status_name is COMPLETED, then name the voice with POST music/cloned-voices/clonedVoiceItemId and use it in POST music/song.

https://api.useapi.net/v1/tempolor/music/cloned-voices/clonedVoiceItemId

Request Headers
Authorization: Bearer {API token}
Path Parameters
  • clonedVoiceItemId is required. The clonedVoiceItemId returned by a previous POST music/cloned-voices request. It names the account that holds the voice, so no user_id is needed.
Status Values
status status_name Description
30 COMPLETED The voice is cloned and ready to name and use
0 PROCESSING TemPolor is still cloning the voice
any other FAILED The clone failed, error gives the status
Responses
  • 200 OK

    Every state answers 200: check status_name. A finished clone:

    {
      "status": 30,
      "name": "",
      "coverUrl": "",
      "itemId": "abcdef123456789",
      "clonedVoiceItemId": "user:12345-tempolor:user_id-voice:abcdef123456789",
      "status_name": "COMPLETED"
    }
    

    A clone that failed has status_name FAILED and error “Voice cloning failed with status: <status>.” with TemPolor’s status number.

  • 400 Bad Request

    {
      "error": "Path parameter clonedVoiceItemId (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 clone’s status from TemPolor with its status_name, and the voice’s name and coverUrl.

The voice clone, field by field
{   // TypeScript, all fields are optional
    status: number  // 30 ready, 0 still cloning, anything else failed
    name: string
    coverUrl: string
    itemId: string
    clonedVoiceItemId: string
    status_name: string  // "COMPLETED", "PROCESSING", "FAILED"
    error: string  // FAILED only
    code: number
}
Examples
  • curl -H "Authorization: Bearer …" \
         "https://api.useapi.net/v1/tempolor/music/cloned-voices/user:12345-tempolor:user_id-voice:abcdef123456789"
    
  • const token = "API token";
    const clonedVoiceItemId = "user:12345-tempolor:user_id-voice:abcdef123456789";
    const apiUrl = `https://api.useapi.net/v1/tempolor/music/cloned-voices/${clonedVoiceItemId}`;
    
    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);
    
  • import requests
    import time
    
    token = "API token"
    cloned_voice_item_id = "user:12345-tempolor:user_id-voice:abcdef123456789"
    apiUrl = f"https://api.useapi.net/v1/tempolor/music/cloned-voices/{cloned_voice_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)
    
Try It