Custom Voices

Get Custom Voice

SDK

Use the SDK for safer, faster integration than manual HTTP calls.

Returns one non-deleted custom voice owned by the authenticated account. Poll this endpoint after starting professional cloning and stop when status becomes completed or failed.

GET/v1/custom-voices/{voice_id}

cURL

curl --request GET \
  --url https://api.typecast.ai/v1/custom-voices/uc_6700000000000000000000bb \
  --header 'X-API-KEY: <api-key>'

{
  "name": "Brand Voice",
  "error": null,
  "model": "ssfm-v30",
  "source": "professional",
  "status": "training",
  "voice_id": "uc_6700000000000000000000bb",
  "created_at": "2026-08-26T04:20:00Z"
}

Authorizations

X-API-KEYstringheaderrequired

API key for authentication. You can obtain an API key from the Typecast API Console.

Path parameters

voice_idstringrequired

Unique custom voice identifier.

Response

200Custom voice retrieved successfullyapplication/json

namestring

Voice name.

errorstring

Failure reason when status is failed.

modelstring

TTS model version.

sourcestring

Creation method (instant or professional).

statuspending | training | completed | failed

Current creation or training status.

pendingtrainingcompletedfailed

voice_idstring

Unique custom voice identifier with the uc_ prefix.

created_atstring

Creation time in UTC.

cURL

curl --request GET \
  --url https://api.typecast.ai/v1/custom-voices/uc_6700000000000000000000bb \
  --header 'X-API-KEY: <api-key>'

{
  "name": "Brand Voice",
  "error": null,
  "model": "ssfm-v30",
  "source": "professional",
  "status": "training",
  "voice_id": "uc_6700000000000000000000bb",
  "created_at": "2026-08-26T04:20:00Z"
}