Specifica di un endpoint a livello di regione

Text-to-Speech offre endpoint API regionali per gli Stati Uniti e l'UE. Se utilizzi un endpoint regionale, i tuoi dati non attivi e in uso rimarranno all'interno dei confini continentali dell'Europa o degli Stati Uniti. La specifica di un endpoint è importante se la posizione dei dati deve essere controllata per rispettare i requisiti normativi locali. Il comportamento dell'API non subirà modifiche.

Quando utilizzi un endpoint a livello di regione, assicurati di includere la località us o eu corrispondente nella stringa parent. Consulta la documentazione di Synthesize per ulteriori informazioni sulla configurazione del corpo della richiesta di sintesi.

Protocollo

Per eseguire la sintesi vocale utilizzando un endpoint regionale, esegui il comando applicabile nella tabella seguente per configurare l'endpoint corretto:

Più regioni	Sostituzione dell'endpoint
UE	$ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com
US	$ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com

Solo le voci Neural2 sono disponibili da questi endpoint:

Area geografica singola	Sostituzione dell'endpoint
US Central1	$ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com

Il seguente esempio di codice mostra come inviare un messaggio synthesis request che limita tutti i dati a una regione specificata. Puoi sostituire l'endpoint regionale EU o US con la variabile CLOUD_TTS_ENDPOINT. Sostituisci PROJECT_ID con l'ID del tuo progetto.

$ 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

Questo esempio utilizza Google Cloud CLI per creare un token di accesso per il tuo Account Google. Per istruzioni sull'installazione di gcloud CLI, consulta Eseguire l'autenticazione per la sintesi vocale.