Google-API-Key hinterlegen oder Sprach-/Stimmoptionen ändern

PUT

/v1/speech/config

curl --request PUT \
  --url https://example.com/v1/speech/config \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "api_key": "example", "tts_language": "de-DE", "tts_voice": "de-DE-Chirp3-HD-Kore", "stt_language": "de-DE" }'

• Adresse aus config.json → api.addr, Standard 127.0.0.1:2330

Der Key wird zuerst gegen Google getestet (Cloud Text-to-Speech + Cloud Speech-to-Text) und nur bei Erfolg gespeichert. Leeres api_key behält den bestehenden Key und ändert nur die übrigen Felder.

Authorizations

• bearerAuth

Request Body^required

Media typeapplication/json

object

api_key

Leer = bestehenden Key behalten

string

tts_language

string

Example

de-DE

tts_voice

string

Example

de-DE-Chirp3-HD-Kore

stt_language

string

Example

de-DE

Responses

200

Erfolg (ok:true) oder fehlgeschlagener Google-Test (ok:false, error) — Letzteres wird als 200 zurückgegeben, nicht als Fehlerstatus.

Media typeapplication/json

object

ok

boolean

error

string

settings

object

configured

boolean

verified

Erst danach zeigt die UI Mikrofon/Vorlesen-Knopf

boolean

verified_at

string format: date-time

tts_language

string

tts_voice

string

stt_language

string

Example^generated

{
  "ok": true,
  "error": "example",
  "settings": {
    "configured": true,
    "verified": true,
    "verified_at": "2026-04-15T12:00:00Z",
    "tts_language": "example",
    "tts_voice": "example",
    "stt_language": "example"
  }
}

400

Kein API-Key übergeben und keiner hinterlegt.

Media typeapplication/json

object

error

string

Example^generated

{
  "error": "example"
}

404

Sprachfunktionen im Daemon nicht aktiviert.

Media typeapplication/json

object

error

string

Example^generated

{
  "error": "example"
}