Text-to-Speech ofrece extremos de API global, de us, de la eu regionales y multirregionales.
Si usas un extremo regional, tus datos en reposo y en uso permanecerán
dentro de los límites regionales o continentales de Europa o EE.UU., respectivamente. Si se debe controlar la ubicación de tus datos para cumplir con los requisitos reglamentarios locales, es importante que especifiques un extremo. No hay cambios funcionales en el comportamiento
de la API.
Global
| Nombre del modelo | Global |
|---|---|
TTS de Gemini 2.5 Flash (gemini-2.5-flash-tts) |
|
TTS de Gemini 2.5 Flash (gemini-2.5-pro-tts) |
|
| Chirp 3: Voces en HD | |
| Chirp 3: Voz personalizada instantánea |
Estados Unidos
| Nombre del modelo | EE.UU. multirregión |
|---|---|
TTS de Gemini 2.5 Flash (gemini-2.5-flash-tts) |
|
TTS de Gemini 2.5 Flash (gemini-2.5-pro-tts) |
|
| Chirp 3: Voces en HD | |
| Chirp 3: Voz personalizada instantánea |
Europa
| UE multirregión | Londres, Reino Unido (europe-west2) | Fráncfort, Alemania (europe-west3) | Puerto de Ems, Países Bajos (europe-west4) | |
|---|---|---|---|---|
TTS de Gemini 2.5 Flash (gemini-2.5-flash-tts) |
||||
TTS de Gemini 2.5 Flash (gemini-2.5-pro-tts) |
||||
| Chirp 3: Voces en HD | ||||
| Chirp 3: Voz personalizada instantánea |
Asia-Pacífico
| Tokio, Japón (asia-northeast1) | Sídney, Australia (australia-southeast1) | Bombay, India (asia-south1) | Singapur (asia-southeast1) | Seúl, Corea (asia-northeast3) | |
|---|---|---|---|---|---|
TTS de Gemini 2.5 Flash (gemini-2.5-flash-tts) |
|||||
TTS de Gemini 2.5 Flash (gemini-2.5-pro-tts) |
|||||
| Chirp 3: Voces en HD | |||||
| Chirp 3: Voz personalizada instantánea |
Usa extremos regionales
Cuando uses un extremo regional, asegúrate de incluir la ubicación us o eu
coincidente en la cadena parent. Consulta la
documentación de
Synthesize para obtener más información sobre cómo configurar el cuerpo de la solicitud para sintetizar.
Protocolo
Para realizar la síntesis de texto a voz con un extremo regional, ejecuta el comando aplicable en la siguiente tabla para configurar el extremo correcto:
| Multirregión | Anulación de extremos |
|---|---|
| UE | $ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com |
| EE.UU. | $ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com |
Solo las voces Neural2 están disponibles desde estos extremos:
| Una sola región | Anulación de extremos |
|---|---|
| US Central1 | $ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com |
En la siguiente muestra de código, se indica cómo enviar una
synthesis request
que mantenga todos los datos limitados a una región específica. Puedes sustituir el extremo
regional EU o US por la
variable CLOUD_TTS_ENDPOINT. Reemplaza PROJECT_ID por el ID del 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 Google Cloud CLI para crear un token de acceso en tu Cuenta de Google. Para obtener instrucciones sobre cómo instalar gcloud CLI, consulta Autentícate en Text-to-Speech.
Restringe el uso del extremo de API global
Para ayudar a aplicar de manera forzosa el uso de extremos regionales, usa la
restricción de políticas de la organización constraints/gcp.restrictEndpointUsage y bloquea
las solicitudes al extremo de API global. Para obtener más información, consulta
Cómo restringir el uso de extremos.