Voice Connectors

this documentation provides an overview of our text to speech (tts) service and how you can manage tts voices for your digital humans using our voice connectors text to speech (tts) overview text to speech (tts) is a service that converts written text into synthesized human like speech your digital human must have a tts voice configured to function correctly our platform's voice connectors are designed to integrate with a variety of external tts providers, offering you a wide selection of voice options we are continuously adding support for new providers if you are interested in creating your own custom voice connector, please reach out to us for more information supported tts providers the platform relies on a number of third party tts providers currently supported providers include elevenlabs microsoft azure audiostack each provider has its own unique set of usable voices, and it is not possible to cross match voices with different providers when creating or updating a digital human head, you need to configure both the ttsprovider and ttsvoice parameters these values must correspond to a valid provider name and a specific voice id from that provider use the /voice/all endpoint to obtain the corresponding provider and voiceid values regional voice compatibility voices available in one region may not be present in others this can cause a digital human created in one region (e g , the us) to not be fully functional in another (e g , the eu or australia) to ensure that the same digital human is fully operational in any region, you can use our common voices file the provided json file contains a list of voices that are guaranteed to be available and fully supported across all regions we recommend using these voices for maximum compatibility and reliability voice management endpoints you can retrieve the list of voices and their corresponding parameters using the following api endpoints 1\ retrieving the full list of voices use the /voice/all endpoint to obtain the complete list of supported voices, including their respective providers and ids endpoint /voice/all method get curl x 'get' \\ 'https //platform api unith ai/voice/all?provider=azure' \\ h 'accept application/json' \\ h 'authorization bearer yourbearertoken' the response data contains the full configuration for each voice, which includes the following controllable parameters parameter description value ttsprovider the specific tts provider name elevenlabs | azure | audiostack ttsvoice the unique voice identifier (voice id) n/a language the human language name n/a languagecode the standard language code (e g , en us) n/a accent the voice's regional accent n/a gender the intended gender characteristic of the voice male | female | neutral | unknown | character 2\ previewing a voice you can instantly preview the audio output for any given voice using the preview endpoint endpoint /voice/preview method get curl x 'get' \\ '\[https //platform api unith ai/voice/preview?voiceid=yourvoiceid\&provider=azure\&text=hello%20world]\(https //platform api unith ai/voice/preview?voiceid=yourvoiceid\&provider=azure\&text=hello%20world)' \\ h 'accept application/json' \\ h 'authorization bearer yourbearertoken' parameter description voiceid the unique id of the voice to preview provider the corresponding tts provider name text the text to be converted to speech for convenience, you can also select and preview voices directly within the platform's user interface (frontend) when creating or editing a digital human head