Custom Voices

List Custom Voices

SDK

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

Lists all non-deleted custom voices owned by the authenticated account, including instant and professional clones. Results can include pending, training, completed, and failed voices.

Use status to decide whether a voice is ready for synthesis. When status is failed, error contains a safe failure reason; otherwise it is null.

GET/v1/custom-voices

cURL

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

[
  {
    "name": "Product Narrator",
    "error": null,
    "model": "ssfm-v30",
    "source": "instant",
    "status": "completed",
    "voice_id": "uc_6700000000000000000000aa",
    "created_at": "2026-08-26T04:15:00Z"
  },
  {
    "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.

Response

200Custom voices 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 \
  --header 'X-API-KEY: <api-key>'

[
  {
    "name": "Product Narrator",
    "error": null,
    "model": "ssfm-v30",
    "source": "instant",
    "status": "completed",
    "voice_id": "uc_6700000000000000000000aa",
    "created_at": "2026-08-26T04:15:00Z"
  },
  {
    "name": "Brand Voice",
    "error": null,
    "model": "ssfm-v30",
    "source": "professional",
    "status": "training",
    "voice_id": "uc_6700000000000000000000bb",
    "created_at": "2026-08-26T04:20:00Z"
  }
]