2024.12.5
Home ▸ Integrations ▸

Yandex TTS

The yandextts text-to-speech integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] uses Yandex SpeechKit text-to-speech engine to read a text with natural sounding voices.

Important

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

Configuration

To enable text-to-speech with Yandex SpeechKit, add the following lines to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file. After changing the configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file, restart Home Assistant to apply the changes. The integration is now shown on the integrations page under Settings > Devices & services. Its entities are listed on the integration card itself and on the Entities tab.

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

Configuration Variables

Looking for your configuration file?
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
tts:
  - platform: yandextts
    api_key: YOUR_API_KEY
    language: "ru-RU"
    codec: mp3
    voice: oksana
    emotion: evil
    speed: 2

Related topics