Gradium Smart-Home-Integration, kostenlos und Open Source
Natural, expressive voices from Gradium for Gladys announcements and voice replies.
Veröffentlicht von PhilippeMA
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.3.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
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.
Konfigurationseinstellungen
Diese Einstellungen fragt Gradium in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Getting started | section | Nein | 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 | Ja | Your Gradium API key. |
| Region | select | Nein | Where Gradium processes your requests. Pick Europe or United States only to pin the data to that region. |
| Voices | section | Nein | 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 | Nein | Identifier of the voice used when the language has no voice of its own. |
| French voice | string | Nein | |
| English voice | string | Nein | |
| German voice | string | Nein | |
| Spanish voice | string | Nein | |
| Portuguese voice | string | Nein | |
| Speaking pace | number | Nein | 0 is the natural pace of the voice. Negative values speak faster, positive values slower. |
| Audio format | select | Nein | WAV plays on every speaker. Opus is much lighter, but some speakers (Sonos among them) cannot play it. |
So installierst du Gradium in Gladys
- Öffne in Gladys Integrationen: Gradium erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/philippema/gladys-gradium:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/PhilippeMA/gladys-gradium.
Gradium benötigt Gladys >=5.3.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Gradium ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von PhilippeMA veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation