Text-to-Speech ofrece extremos de la API regionales de EE.UU. y la UE. Si usas un extremo regional, tus datos en reposo y en uso permanecerán dentro de los límites continentales de Europa o EE.UU. Especificar un extremo es importante si se debe controlar la ubicación de tus datos para cumplir con los requisitos reglamentarios locales. No hay cambios funcionales en el comportamiento de la API.
Cuando uses un extremo regional, asegúrate de incluir la ubicación us o eu coincidente en la string parent. Consulta la documentación de Synthesize para obtener más información sobre la configuración del cuerpo de la solicitud de sintetizar.
Protocolo
Para realizar la síntesis de texto a voz con un extremo regional, ejecuta el comando aplicable en la siguiente tabla a fin de configurar el extremo correcto:
| Multirregión | Anulación de extremos |
|---|---|
| UE | $ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com |
| EE.UU. | $ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com |
Solo las voces Neural2 están disponibles desde estos extremos:
| Una sola región | Anulación de extremos |
|---|---|
| US Central1 | $ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com |
En la siguiente muestra de código, se indica cómo enviar un synthesis request que mantiene todos los datos limitados a una región específica. Puedes sustituir el extremo regional EU o US por la variable CLOUD_TTS_ENDPOINT. Reemplaza PROJECT_ID por el ID del proyecto.
$ 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
En este ejemplo, se usa Google Cloud CLI para crear un token de acceso para tu Cuenta de Google. Para obtener instrucciones sobre cómo instalar gcloud CLI, consulta Autentícate en Text-to-Speech.