A Text-to-Speech oferece endpoints de API multirregionais e regionais global, us e eu.
Se você usar um endpoint regional, os dados em repouso e em uso vão permanecer
dentro dos limites regionais ou continentais da Europa ou dos EUA, respectivamente. Se a localização dos dados precisar ser controlada para obedecer aos requisitos regulamentares locais, é importante especificar um endpoint. Não há alteração funcional no comportamento
da API.
Global
| Nome do modelo | Global |
|---|---|
TTS do Gemini 2.5 Flash (gemini-2.5-flash-tts) |
|
TTS do Gemini 2.5 Flash (gemini-2.5-pro-tts) |
|
| Chirp 3: vozes em alta definição | |
| Chirp 3: Voz Personalizada Instantânea |
Estados Unidos
| Nome do modelo | EUA multirregião |
|---|---|
TTS do Gemini 2.5 Flash (gemini-2.5-flash-tts) |
|
TTS do Gemini 2.5 Flash (gemini-2.5-pro-tts) |
|
| Chirp 3: vozes em alta definição | |
| Chirp 3: Voz Personalizada Instantânea |
Europa
| UE multirregião | Londres, Reino Unido (europe-west2) | Frankfurt, Alemanha (europe-west3) | Eemshaven, Países Baixos (europe-west4) | |
|---|---|---|---|---|
TTS do Gemini 2.5 Flash (gemini-2.5-flash-tts) |
||||
TTS do Gemini 2.5 Flash (gemini-2.5-pro-tts) |
||||
| Chirp 3: vozes em alta definição | ||||
| Chirp 3: Voz Personalizada Instantânea |
Ásia-Pacífico
| Tóquio, Japão (asia-northeast1) | Sydney, Austrália (australia-southeast1) | Mumbai, Índia (asia-south1) | Singapura (asia-southeast1) | Seul, Coreia (asia-northeast3) | |
|---|---|---|---|---|---|
TTS do Gemini 2.5 Flash (gemini-2.5-flash-tts) |
|||||
TTS do Gemini 2.5 Flash (gemini-2.5-pro-tts) |
|||||
| Chirp 3: vozes em alta definição | |||||
| Chirp 3: Voz Personalizada Instantânea |
Usar endpoints regionais
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:
| Multirregional | Substituiçã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.
Restringir o uso de endpoints de API globais
Para ajudar na aplicação do uso de endpoints regionais, utilize a
restrição de política da organização constraints/gcp.restrictEndpointUsage para
bloquear solicitações ao endpoint da API global. Para mais informações, consulte
Restringir o uso de endpoints.