A API Text-to-Speech oferece pontos finais de API regionais e multirregionais global, us e eu.
Se usar um ponto final regional, os seus dados em repouso e em utilização permanecem
dentro dos limites regionais ou continentais da Europa ou dos EUA, respetivamente. Se a localização dos seus dados tiver de ser controlada para estar em conformidade com os requisitos regulamentares locais, é importante especificar um ponto final. Não existe nenhuma alteração funcional ao comportamento da API.
Global
| Nome do modelo | Multirregião dos EUA |
|---|---|
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts) |
|
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts) |
|
| Chirp 3: vozes HD | |
| Chirp 3: voz personalizada instantânea |
Estados Unidos
| Nome do modelo | Multirregião dos EUA |
|---|---|
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts) |
|
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts) |
|
| Chirp 3: vozes HD | |
| Chirp 3: voz personalizada instantânea |
Europa
| Multirregional da UE | Londres, Reino Unido (europe-west2) | Frankfurt, Alemanha (europe-west3) | Eemshaven, Países Baixos (europe-west4) | |
|---|---|---|---|---|
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts) |
||||
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts) |
||||
| Chirp 3: vozes HD | ||||
| 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) | |
|---|---|---|---|---|---|
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts) |
|||||
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts) |
|||||
| Chirp 3: vozes HD | |||||
| Chirp 3: voz personalizada instantânea |
Use pontos finais regionais
Quando usa um ponto final regional, certifique-se de que inclui a localização us ou eu correspondente na string parent. Consulte a
Synthesize
documentação para mais informações sobre a configuração do corpo do pedido de síntese.
Protocolo
Para realizar a síntese de voz através de um ponto final regional, execute o comando aplicável na tabela abaixo para configurar o ponto final correto:
| Multirregião | Substituição do ponto final |
|---|---|
| UE | $ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com |
| EUA | $ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com |
Apenas as vozes Neural2 estão disponíveis nestes pontos finais:
| Região única | Substituição do ponto final |
|---|---|
| Centro dos EUA1 | $ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com |
O exemplo de código seguinte demonstra como enviar um
synthesis request
que mantém todos os dados confinados a uma região especificada. Pode substituir o ponto final regional EU ou US pela variável CLOUD_TTS_ENDPOINT. Substitua PROJECT_ID pelo ID do seu 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 Google Cloud para criar um token de acesso para a sua Conta Google. Para ver instruções sobre como instalar a CLI gcloud, consulte o artigo Autentique-se na API Text-to-Speech.
Restrinja a utilização do ponto final da API global
Para ajudar a aplicar a utilização de pontos finais regionais, use a restrição da política da organização constraints/gcp.restrictEndpointUsage para bloquear pedidos ao ponto final da API global. Para mais informações, consulte o artigo
Restringir a utilização de pontos finais.