v1

latestOpenAPI 3.1.02026-07-13212942.9 KB

Synth Voices

Get Voice

Retrieve a single voice by its UUID.

Result is cached in Redis (TTL controlled by the VOICE_CACHE_TTL env var, default 72 h).

Args: voice_id: UUID of the voice to retrieve. x_api_key: Bearer API key from the x-api-key header. token_service: Injected token validation service. request: Raw FastAPI Request. version: API version extracted from the version request header.

Returns: VoiceResponse: Voice metadata.

Raises: VoiceNotFound: When the voice does not exist or is not accessible by the caller.

get/voices/{voice_id}

Path parameters

voice_idstring uuid required

Headers

version'v1'

X-Api-Keystring

Response

Successful Response

voice_idstring uuid required

namestring required

descriptionstring nullable required

languagestring nullable required

gender'Male' | 'Female' | 'Neutral' | 'Unspecified' required

accentstring nullable required

stylestring nullable required

created_atstring date-time required

updated_atstring date-time required

voice_type'PREDEFINED' | 'CUSTOM' required