Especificar um endpoint regional

A Text-to-Speech oferece endpoints de API regionais dos EUA e da UE. Se você usar um endpoint regional, os dados em repouso e em uso vão permanecer dentro dos limites continentais da Europa ou dos EUA. Especificar um endpoint é importante se o local dos dados precisar ser controlado para cumprir os requisitos regulamentares locais. Não há alteração funcional no comportamento da API.

Ao usar um endpoint regional, inclua o local us ou eu correspondente na string parent. Consulte a documentação Synthesize para mais informações sobre como configurar o corpo da solicitação de sintetização.

Protocolo

Para executar a síntese da conversão de texto em voz usando um endpoint regional, execute o comando aplicável na tabela abaixo para configurar o endpoint correto:

Multirregião	Modificação do endpoint
UE	$ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com
EUA	$ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com

Somente as vozes Neural2 estão disponíveis nestes endpoints:

Única região	Modificação do endpoint
US Central1	$ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com

O exemplo de código a seguir demonstra como enviar um synthesis request que mantém todos os dados restritos a uma região específica. É possível substituir o endpoint regional EU ou US pela variável CLOUD_TTS_ENDPOINT. Substitua PROJECT_ID pelo ID do projeto.

$ 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

Este exemplo usa a CLI do Google Cloud para criar um token de acesso para sua Conta do Google. Para instruções sobre como instalar a gcloud CLI, consulte Autenticar na Text-to-Speech.