Yandex TTS

The yandextts text-to-speech platform uses Yandex SpeechKit text-to-speech engine to read a text with natural sounding voices.

This integration is working only with old API keys. For the new API keys, this integration cannot be used.


To enable text-to-speech with Yandex SpeechKit, add the following lines to your configuration.yaml:

# Example configuration.yaml entry
  - platform: yandextts
    api_key: THE_API_KEY

Configuration Variables

api_key string Required

The API Key for use this service.

language string (Optional, default: en-US)

The language to use. Supported languages are en-US, ru-RU, uk-UK and tr-TR.

codec string (Optional, default: mp3)

The audio codec. Supported codecs are mp3, wav and opus.

voice string (Optional, default: zahar)

The speaker voice. Supported female voices are jane, oksana, alyss, omazh, silaerkan, nastya, sasha, tanya, tatyana_abramova, voicesearch, and zombie. Male voices are zahar, ermil, levitan, ermilov, kolya, kostya, nick, erkanyavas, zhenya, anton_samokhvalov, ermil_with_tuning, robot, dude, and smoky.

emotion string (Optional, default: neutral)

The speaker emotional intonation. Supported emotions are good (friendly), evil (angry) and neutral

speed float (Optional, default: 1)

The speech speed. Highest speed is 3 and lowest 0,1

Please check the API documentation for details. It seems that the English version of documentation is outdated. You could request an API key by email or online.

Full configuration example

The configuration sample below shows how an entry can look like:

# Example configuration.yaml entry
  - platform: yandextts
    api_key: YOUR_API_KEY
    language: "ru-RU"
    codec: mp3
    voice: oksana
    emotion: evil
    speed: 2