Check a voice clone
November 21, 2026
Table of contents
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}
API tokenis required, see Setup useapi.net for details.
Path Parameters
clonedVoiceItemIdis required. TheclonedVoiceItemIdreturned by a previous POST music/cloned-voices request. It names the account that holds the voice, so nouser_idis 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
-
Every state answers
200: checkstatus_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_nameFAILEDanderror“Voice cloning failed with status:<status>.” with TemPolor’s status number. -
{ "error": "Path parameter clonedVoiceItemId (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 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)