Text-to-Speech offre endpoint API regionali negli Stati Uniti e nell'UE. Se utilizzi un endpoint regionale, i dati at-rest e in uso rimarranno entro i confini continentali dell'Europa o degli Stati Uniti. La specifica di un endpoint è importante se la località dei dati deve essere controllata per rispettare i requisiti normativi locali. Non sono state apportate modifiche al comportamento dell'API.
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 saperne di più sulla configurazione del corpo della richiesta di sintesi.
Protocollo
Per eseguire la sintesi vocale utilizzando un endpoint a livello di regione, esegui il comando applicabile nella tabella seguente per configurare l'endpoint corretto:
| Più regioni | Override 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 | Override endpoint |
|---|---|
| US Central1 | $ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com |
Il seguente esempio di codice mostra come inviare un elemento synthesis request che mantiene tutti i dati limitati a una regione specificata. Puoi sostituire
l'endpoint regionale EU o US per la
variabile CLOUD_TTS_ENDPOINT. Sostituisci PROJECT_ID con l'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 Autenticazione in Text-to-Speech.