Text-to-Speech bietet regionale API-Endpunkte für die USA und EU. Wenn Sie einen regionalen Endpunkt verwenden, bleiben Ihre inaktiven und verwendeten Daten innerhalb der kontinentalen Grenzen von Europa oder den USA. Die Angabe eines Endpunkts ist wichtig, wenn der Standort Ihrer Daten lokalen gesetzlichen Anforderungen genügen muss. Das Verhalten der API bleibt unverändert.
Wenn Sie einen regionalen Endpunkt verwenden, müssen Sie den entsprechenden us- oder eu-Standort in den parent-String aufnehmen. Weitere Informationen zum Konfigurieren des Texts der Synthetisierungsanfrage finden Sie in der Synthesize-Dokumentation.
Protokoll
Um eine synthetische Sprachausgabe mit einem regionalen Endpunkt zu erstellen führen Sie den entsprechenden Befehl in der folgenden Tabelle aus, um den benötigten Endpunkt zu konfigurieren:
| Mehrere Regionen | Endpunktüberschreibung |
|---|---|
| EU | $ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com |
| USA | $ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com |
Von diesen Endpunkten sind nur Neural2-Stimmen verfügbar:
| Eine Region | Endpunktüberschreibung |
|---|---|
| US Central1 | $ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com |
Im folgenden Codebeispiel wird gezeigt, wie Sie ein synthesis request senden, das alle Daten auf eine bestimmte Region beschränkt. Sie können den regionalen EU- oder US-Endpunkt durch die CLOUD_TTS_ENDPOINT-Variable ersetzen. Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID.
$ curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
-H "Content-Type: application/json; charset=utf-8" \
--data "{
'input':{
'text':'Android is a mobile operating system developed by Google,
based on the Linux kernel and designed primarily for
touchscreen mobile devices such as smartphones and tablets.'
},
'voice':{
'languageCode':'en-gb',
'name':'en-GB-Neural2-A',
'ssmlGender':'FEMALE'
},
'audioConfig':{
'audioEncoding':'MP3'
}
}" $CLOUD_TTS_ENDPOINT/v1/text:synthesize > synthesize-text.txt
In diesem Beispiel wird die Google Cloud CLI verwendet, um ein Zugriffstoken für Ihr Google-Konto zu erstellen. Eine Anleitung zum Installieren der gcloud CLI finden Sie unter Bei Text-to-Speech authentifizieren.