Especificar un endpoint regional

Text-to-Speech ofrece endpoints de API regionales de EE. UU. y la Unión Europea. Si usas un endpoint regional, tus datos en reposo y en uso permanecerán dentro de las fronteras continentales de Europa o de EE. UU. Es importante especificar un endpoint si la ubicación de tus datos debe controlarse para cumplir los requisitos normativos locales. No se ha producido ningún cambio funcional en el comportamiento de la API.

Usar endpoints regionales

Cuando uses un endpoint regional, asegúrate de incluir la ubicación us o eu correspondiente en la cadena parent. Para obtener más información sobre cómo configurar el cuerpo de la solicitud de síntesis, consulta la documentación de Synthesize.

Protocolo

Para realizar la síntesis de texto a voz con un endpoint regional, ejecuta el comando correspondiente de la tabla que aparece a continuación para configurar el endpoint correcto:

Multirregional Sustitución de endpoint
Unión Europea $ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com
US $ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com

Solo las voces de Neural2 están disponibles en estos endpoints:

Para una sola región Sustitución de endpoint
US Central1 $ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com

En el siguiente ejemplo de código se muestra cómo enviar un synthesis request que mantiene todos los datos confinados en una región específica. Puedes sustituir la variable CLOUD_TTS_ENDPOINT por el endpoint regional EU o US. Sustituye PROJECT_ID por el ID de tu 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 la CLI de Google Cloud para crear un token de acceso para tu cuenta de Google. Para obtener instrucciones sobre cómo instalar gcloud CLI, consulta Autenticarse en Text-to-Speech.

Restringir el uso de endpoints de API globales

Para ayudar a aplicar el uso de endpoints regionales, usa la restricción de la política de organización constraints/gcp.restrictEndpointUsage para bloquear las solicitudes al endpoint de la API global. Para obtener más información, consulta Restringir el uso de endpoints.