Home Assistant Home Assistant

IBM Watson TTS

The watson_tts text-to-speech platform that works with IBM Watson Cloud to create the spoken output. Watson is a paid service via IBM Cloud but there is a decent free tier which offers 10000 free characters every month.

Setup

For supported formats and voices please go to IBM Cloud About section.

To get started please read the Getting started tutorial.

Configuration

To configure Watson TTS, add the following lines to your configuration.yaml:

# Example configuration.yaml entry
tts:
  - platform: watson_tts
    watson_apikey: YOUR_GENERATED_APIKEY

You can get these tokens after you generated the credentials on the IBM Cloud console:

Configuration Variables

Looking for your configuration file?
watson_url string (Optional)

The endpoint to which the service will connect.

Default:

https://api.us-south.text-to-speech.watson.cloud.ibm.com

watson_apikey string Required

Your secret apikey generated on the IBM Cloud admin console.

voice string (Optional, default: en-US_AllisonV3Voice)

Voice name to be used.

output_format string (Optional, default: audio/mp3)

Override the default output format. Supported formats: audio/flac, audio/mp3, audio/mpeg, audio/ogg, audio/ogg;codecs=opus, audio/ogg;codecs=vorbis, audio/wav

Usage

Say to all media_player device entities:

- service: tts.watson_tts_say
  data:
    message: "Hello from Watson"

or

- service: tts.watson_tts_say
  data:
    message: >
      <speak>
          Hello from Watson
      </speak>

Say to the media_player.living_room device entity:

- service: tts.watson_tts_say
  target:
    entity_id: media_player.living_room
  data:
    message: >
      <speak>
          Hello from Watson
      </speak>

Say with break:

- service: tts.watson_tts_say
  data:
    message: >
      <speak>
          Hello from
          <break time=".9s" />
          Watson
      </speak>

Optionally, specify a voice for the message:

- service: tts.watson_tts_say
  data:
    message: "Hello from Watson"
  options:
    voice: en-US_EmilyV3Voice