Specifica di un endpoint a livello di regione

Text-to-Speech offre endpoint API regionali per Stati Uniti e 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. Non c'è alcuna modifica funzionale al comportamento l'API.

Quando utilizzi un endpoint a livello di regione, assicurati di includere il valore us o eu corrispondente posizione nella stringa parent. Consulta le Synthesize documentazione per ulteriori informazioni sulla configurazione della richiesta di sintesi del testo.

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

Da questi endpoint sono disponibili solo le voci Neural2:

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 synthesis request che mantiene tutti i dati confinati in una regione specifica. Puoi sostituire l'endpoint regionale EU o US con la variabile CLOUD_TTS_ENDPOINT. Sostituisci PROJECT_ID con il tuo ID 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.