Integración domótica Gradium, gratuita y de código abierto
Natural, expressive voices from Gradium for Gladys announcements and voice replies.
Publicado por PhilippeMA
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.3.0
- ★ 0
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
This integration makes Gladys speak with the voices of Gradium, a text-to-speech service with natural and expressive voices in English, French, German, Spanish and Portuguese.
Once selected as the voice of your instance, Gradium speaks:
- the "play a notification" scene action, on your speakers;
- the replies of the voice assistant.
Gradium is a cloud service: the texts to speak are sent to Gradium, and each synthesis uses credits of your Gradium account.
Requirements
- Gladys Assistant 5.3.0 or later.
- A Gradium account and an API key. The free plan is enough to try.
Configuration
- Sign in to Gradium Studio, open the API keys page and create a key. Copy it: it is shown only once.
- In Gladys, open the Configuration tab of the integration, paste the key in API key and save.
- Press Test the connection: the message shows your remaining credits.
- Open the Artificial Intelligence page of Gladys and select Gradium in the Voice card. Until you do, Gladys keeps its previous voice.
Choosing the voices
Gradium identifies a voice by a short identifier, such as YTpq7expH9539ERJ.
- Press List the voices to display the voices of the Gradium catalog and your own voices (cloned or designed in Gradium Studio), with their language and identifier. Gradium Studio also lets you listen to each voice and copy its identifier.
- Default voice is used whenever the language has no voice of its own.
- French voice, English voice, German voice, Spanish voice and Portuguese voice are optional. Gladys speaks in the language of the user who asked: fill in the voice of a language to use it for that language.
A voice speaks best in its own language: if your household uses French, put a French voice in French voice (or in Default voice).
Other settings
- Region: leave Automatic unless you want your requests processed only in Europe or only in the United States.
- Speaking pace:
0is the natural pace of the voice. Negative values (down to-4) speak faster, positive values (up to4) slower. - Audio format: WAV plays on every speaker. Opus is much lighter and suits long texts, but some speakers, Sonos among them, cannot play it.
Limits
- Gladys sends at most 2,000 characters per synthesis and accepts a clip of 5 MB. In WAV, a clip longer than about 50 seconds is automatically stored at a lower sample rate to fit; the voice stays clear.
- A synthesis must complete within 30 seconds.
- Gradium offers speech-to-text too, but Gladys has no speech-to-text integration type yet: this integration only speaks.
Troubleshooting
- "Gradium refused the API key": the key is wrong or was revoked. Create a new one in Gradium Studio and paste it again.
- "Credits exhausted or too many requests": check your balance with Test the connection, and your plan in Gradium Studio.
- Gladys does not speak with Gradium: check that Gradium is selected in the Voice card of the Artificial Intelligence page.
- The speaker stays silent in Opus: switch Audio format back to WAV.
- The voice has an accent: the voice does not match the language. Set a voice of that language in the matching field.
The Logs tab of the integration shows the reason of every failed synthesis. The API key is never written to the logs.
Parámetros de configuración
Estos son los parámetros que Gradium te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Getting started | section | No | Create an API key in Gradium Studio, paste it below and save. Then select Gradium in the Voice card of the Artificial Intelligence page of Gladys. |
| API key | secret | Sí | Your Gradium API key. |
| Region | select | No | Where Gradium processes your requests. Pick Europe or United States only to pin the data to that region. |
| Voices | section | No | A voice is chosen by its identifier. The List the voices button below shows the identifiers of the Gradium catalog and of your own voices. Gladys speaks in the language of the user: set a voice for a language to use it instead of the default voice. |
| Default voice | string | No | Identifier of the voice used when the language has no voice of its own. |
| French voice | string | No | |
| English voice | string | No | |
| German voice | string | No | |
| Spanish voice | string | No | |
| Portuguese voice | string | No | |
| Speaking pace | number | No | 0 is the natural pace of the voice. Negative values speak faster, positive values slower. |
| Audio format | select | No | WAV plays on every speaker. Opus is much lighter, but some speakers (Sonos among them) cannot play it. |
Cómo instalar Gradium en Gladys
- En Gladys, abre Integraciones: Gradium aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/philippema/gladys-gradium:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/PhilippeMA/gladys-gradium.
Gradium requiere Gladys >=5.3.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Gradium es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene PhilippeMA, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación