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.