google_cloud platform allows you to use Google Cloud Platform API and integrate them into Home Assistant.
To use Google Cloud Platform, you need to provide
config directory relative path of
API key file you are going to use. Place it under
config folder and set
key_file parameter in
# Example configuration.yaml entry tts: - platform: google_cloud key_file: googlecloud.json
API key obtaining process described in corresponding documentation:
Basic instruction for all APIs:
Visit Cloud Resource Manager.
CREATE PROJECTbutton at the top.
Project nameand click
Enable needed Cloud API visiting one of the links below or APIs library, selecting your
Projectfrom the dropdown list and clicking the
Set up authentication:
- Visit this link
- From the
Service accountlist, select
New service account.
- In the
Service account namefield, enter any name.
If you are requesting Text-to-Speech API key:
- Don’t select a value from the Role list. No role is required to access this service.
Create. A note appears, warning that this service account has no role.
Create without role. A JSON file that contains your
API keydownloads to your computer.
Google Cloud Text-to-Speech converts text into human-like speech in more than 100 voices across 20+ languages and variants. It applies groundbreaking research in speech synthesis (WaveNet) and Google’s powerful neural networks to deliver high-fidelity audio. With this easy-to-use API, you can create lifelike interactions with your users that transform customer service, device interaction, and other applications.
The Cloud Text-to-Speech API is priced monthly based on the amount of characters to synthesize into audio sent to the service.
|Feature||Monthly free tier||Paid usage|
|Standard (non-WaveNet) voices||0 to 4 million characters||$4.00 USD / 1 million characters|
|WaveNet voices||0 to 1 million characters||$16.00 USD / 1 million characters|
(string)(Optional)The [`API key`](#obtaining-api-key) file to use with Google Cloud Platform. If not specified `os.environ['GOOGLE_APPLICATION_CREDENTIALS']` path will be used.
(string)(Optional)Default language of the voice, e.g. `en-US`. Supported languages, genders and voices listed [here](https://cloud.google.com/text-to-speech/docs/voices).
Default value: en-US
(string)(Optional)Default gender of the voice, e.g. `male`. Supported languages, genders and voices listed [here](https://cloud.google.com/text-to-speech/docs/voices).
Default value: neutral
(string)(Optional)Default voice name, e.g. `en-US-Wavenet-F`. Supported languages, genders and voices listed [here](https://cloud.google.com/text-to-speech/docs/voices). **Important! This parameter will override `language` and `gender` parameters if set**.
(string)(Optional)Default audio encoder. Supported encodings are `ogg_opus`, `mp3` and `linear16`.
Default value: ogg_opus
(float)(Optional)Default rate/speed of the voice, in the range [0.25, 4.0]. 1.0 is the normal native speed supported by the specific voice. 2.0 is twice as fast, and 0.5 is half as fast. If unset(0.0), defaults to the native 1.0 speed.
Default value: 1.0
(float)(Optional)Default pitch of the voice, in the range [-20.0, 20.0]. 20 means increase of 20 semitones from the original pitch. -20 means decrease of 20 semitones from the original pitch.
Default value: 0.0
(float)(Optional)Default volume gain (in dB) of the voice, in the range [-96.0, 16.0]. If unset, or set to a value of 0.0 (dB), will play at normal native signal amplitude. A value of -6.0 (dB) will play at approximately half the amplitude of the normal native signal amplitude. A value of +6.0 (dB) will play at approximately twice the amplitude of the normal native signal amplitude. Strongly recommend not to exceed +10 (dB) as there's usually no effective increase in loudness for any value greater than that.
Default value: 0.0
(list)(Optional)An identifier which selects 'audio effects' profiles that are applied on (post synthesized) text to speech. Effects are applied on top of each other in the order they are given. Supported profile ids listed [here](https://cloud.google.com/text-to-speech/docs/audio-profiles).
Default value: 
The Google Cloud Text-to-Speech configuration can look like:
# Example configuration.yaml entry tts: - platform: google_cloud key_file: googlecloud.json language: en-US gender: male voice: en-US-Wavenet-F encoding: linear16 speed: 0.9 pitch: -2.5 gain: -5.0 profiles: - telephony-class-application - wearable-class-device