Regionalen Endpunkt angeben

Text-to-Speech bietet multiregionale und regionale API-Endpunkte für global, us und eu. Wenn Sie einen regionalen Endpunkt verwenden, bleiben Ihre inaktiven und verwendeten Daten innerhalb der regionalen oder kontinentalen Grenzen von Europa bzw. den USA. Die Angabe eines Endpunkts ist wichtig, wenn der Standort Ihrer Daten lokalen gesetzlichen Anforderungen genügen muss. Das Verhalten der API bleibt funktionell unverändert.

Global

Modellname Global
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts)
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts)
Chirp 3: HD-Stimmen
Chirp 3: Instant-Custom Voice

USA

Modellname USA (mehrere Regionen)
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts)
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts)
Chirp 3: HD-Stimmen
Chirp 3: Instant-Custom Voice

Europa

EU (mehrere Regionen) London, Vereinigtes Königreich (europe-west2) Frankfurt, Deutschland (europe-west3) Eemshaven, Niederlande (europe-west4)
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts)
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts)
Chirp 3: HD-Stimmen
Chirp 3: Instant-Custom Voice

Asiatisch-pazifischer Raum

Tokio, Japan (asia-northeast1) Sydney, Australien (australia-southeast1) Mumbai, Indien (asia-south1) Singapur (asia-southeast1) Seoul, Korea (asia-northeast3)
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts)
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts)
Chirp 3: HD-Stimmen
Chirp 3: Instant-Custom Voice

Regionale Endpunkte verwenden

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 Sprachausgabesynthese mit einem regionalen Endpunkt durchzuführen, 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

An diesen Endpunkten sind nur Neural2-Stimmen verfügbar:

Einzelne Region Endpunktüberschreibung
US Central1 $ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com

Im folgenden Codebeispiel wird gezeigt, wie Sie einen synthesis request senden, der 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 dabei 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 mit der Google Cloud CLI ein Zugriffstoken für Ihr Google-Konto erstellt. Eine Anleitung zur Installation der gcloud CLI finden Sie unter Bei Text-to-Speech authentifizieren.

Nutzung globaler API-Endpunkte einschränken

Um die Verwendung regionaler Endpunkte zu erzwingen, können Sie die Einschränkung der Organisationsrichtlinie constraints/gcp.restrictEndpointUsage verwenden, um Anfragen an den globalen API-Endpunkt zu blockieren. Weitere Informationen finden Sie unter Endpunktnutzung einschränken.