From 7a1cbb4a2bb4b7cc4c3f454f319762155808bf1a Mon Sep 17 00:00:00 2001 From: Simon <80467011+sorgfresser@users.noreply.github.com> Date: Tue, 28 Jan 2025 13:29:28 +0000 Subject: [PATCH] Add speak action configuration for ElevenLabs (#36522) * Add speak action configuration for ElevenLabs * tiny tweak --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/elevenlabs.markdown | 25 ++++++++++++++++++++++-- 1 file changed, 23 insertions(+), 2 deletions(-) diff --git a/source/_integrations/elevenlabs.markdown b/source/_integrations/elevenlabs.markdown index a6b27e66389..02bdedc78c5 100644 --- a/source/_integrations/elevenlabs.markdown +++ b/source/_integrations/elevenlabs.markdown @@ -15,11 +15,12 @@ ha_codeowners: --- The **ElevenLabs** text-to-speech {% term integrations %} adds support for [ElevenLabs](https://elevenlabs.io/) as text-to-speech to read a text with natural sounding voices. + ## Prerequisites -- You need an ElevenLabs account to use this integration. A free account suffices for basic usage. +- You need an ElevenLabs account to use this integration. A free account suffices for basic usage. - For custom voices or more quota you need a subscription. -- You need your API key from the ElevenLabs website. +- You need your API key from the ElevenLabs website. {% include integrations/config_flow.md %} @@ -44,8 +45,28 @@ target: data: media_player_entity_id: media_player.giant_tv message: Hello, can you hear me now? + options: + voice: + model: ``` +### Configuration + +Below settings can be configured in the options of the integration and in the `options` parameter of the `tts.speak` service. + +{% configuration %} + +voice: + description: "Voice ID for the ElevenLabs voice to use. Will override the default voice of the entity!" + required: false + type: string +model: + description: "Model ID for the model to use. Will override the default model of the entity!" + required: false + type: string + +{% endconfiguration %} + For more information about using text-to-speech with Home Assistant and more details on all the options it provides, see the [TTS documentation](/integrations/tts/). ## Removing the integration