Skip to navigation
API ReferenceVoices

Get Voice

Fetch a single voice by id - a shared catalogue voice or one of the workspace’s cloned voices. A cloned voice that belongs to another workspace returns 404, identical to an unknown id, so voice inventory is never enumerable across tenants.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. 'Bearer sk_...'.

Path parameters

voice_idstringRequired
The ID of the voice to fetch

Headers

Speechify-VersionstringOptional

Response headers

Speechify-Request-IdstringOptional

Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends a Speechify-Request-Id request header the server echoes it back (sanitized and length-capped) so one logical request can be traced end-to-end; otherwise the server generates a fresh value. Log it on every response and quote it in support requests

  • it is the stable handle that ties your observation to Speechify's server-side logs, and it matches the request_id field in the error envelope.

The legacy alias X-Request-ID carries the same value and is still accepted on requests, until 2027-07-24. Prefer the un-prefixed name (RFC 6648).

RateLimit-LimitintegerOptional

Request-rate budget: the maximum number of requests in the current window (the bucket capacity). The IETF-draft un-prefixed name; the legacy alias X-RateLimit-Limit carries the same value. Rides every response.

RateLimit-RemainingintegerOptional

Request-rate budget: requests left in the current window. Legacy alias: X-RateLimit-Remaining.

RateLimit-ResetintegerOptional

Request-rate budget: integer delta-seconds until the window fully refills (same unit as Retry-After). Legacy alias: X-RateLimit-Reset.

Response

The voice.
display_namestring
genderenum
Allowed values:
localestring
idstring
modelslist of objects
typeenum
Allowed values:
avatar_imagestring or nullOptional
preview_audiostring or nullOptional
project_idstringOptionalformat: "^proj_[0-9a-hjkmnp-tv-z]{26}$"

The workspace project this cloned voice is filed under, set when a project-pinned key created it. Returned wherever a cloned voice is: the list, a single-voice read, and the create response.

Omitted for a shared-catalog voice and for a cloned voice no project filed, which is shared with the whole workspace and listed for every member of it.

can_managebooleanOptional

Whether this workspace may delete the voice and download its sample through this API. true for a cloned voice the workspace owns. false for a shared-catalog voice, and for a cloned voice that reaches this workspace only through its creator's personal account (a voice cloned before workspace ownership, or under another Speechify product), which is managed where it was made.

tagslist of strings or nullOptional

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
502
Bad Gateway Error
503
Service Unavailable Error