Text-to-Speech ofrece endpoints de API multirregionales y regionales global, us y eu.
Si usas un endpoint regional, tus datos en reposo y en uso se quedarán dentro de los límites regionales o continentales de Europa o de EE. UU., respectivamente. Si debe controlar la ubicación de sus datos para cumplir los requisitos normativos locales, es importante que especifique un endpoint. No se ha producido ningún cambio funcional en el comportamiento de la API.
Global
| Nombre del modelo | Multirregional de EE. UU. |
|---|---|
Síntesis de voz de Gemini 2.5 Flash (gemini-2.5-flash-tts) |
|
Síntesis de voz de Gemini 2.5 Flash (gemini-2.5-pro-tts) |
|
| Chirp 3: voces en HD | |
| Chirp 3: Voz personalizada al instante |
Estados Unidos
| Nombre del modelo | Multirregional de EE. UU. |
|---|---|
Síntesis de voz de Gemini 2.5 Flash (gemini-2.5-flash-tts) |
|
Síntesis de voz de Gemini 2.5 Flash (gemini-2.5-pro-tts) |
|
| Chirp 3: voces en HD | |
| Chirp 3: Voz personalizada al instante |
Europa
| Multirregional de la UE | Londres (Reino Unido) (europe-west2) | Fráncfort (Alemania) (europe-west3) | Eemshaven (Países Bajos) (europe-west4) | |
|---|---|---|---|---|
Síntesis de voz de Gemini 2.5 Flash (gemini-2.5-flash-tts) |
||||
Síntesis de voz de Gemini 2.5 Flash (gemini-2.5-pro-tts) |
||||
| Chirp 3: voces en HD | ||||
| Chirp 3: Voz personalizada al instante |
Asia-Pacífico
| Tokio (Japón) (asia-northeast1) | Sídney (Australia) (australia-southeast1) | Bombay (India) (asia-south1) | Singapur (asia-southeast1) | Seúl (Corea del Sur) (asia-northeast3) | |
|---|---|---|---|---|---|
Síntesis de voz de Gemini 2.5 Flash (gemini-2.5-flash-tts) |
|||||
Síntesis de voz de Gemini 2.5 Flash (gemini-2.5-pro-tts) |
|||||
| Chirp 3: voces en HD | |||||
| Chirp 3: Voz personalizada al instante |
Usar endpoints regionales
Cuando uses un endpoint regional, asegúrate de incluir la ubicación us o eu correspondiente en la cadena parent. Para obtener más información sobre cómo configurar el cuerpo de la solicitud de síntesis, consulta la documentación de Synthesize.
Protocolo
Para realizar la síntesis de texto a voz con un endpoint regional, ejecuta el comando correspondiente de la tabla que aparece a continuación para configurar el endpoint correcto:
| Multirregional | Sustitución de endpoint |
|---|---|
| Unión Europea | $ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com |
| US | $ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com |
Solo las voces de Neural2 están disponibles en estos endpoints:
| Para una sola región | Sustitución de endpoint |
|---|---|
| US Central1 | $ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com |
En el siguiente ejemplo de código se muestra cómo enviar un synthesis request que mantiene todos los datos confinados en una región específica. Puedes sustituir la variable CLOUD_TTS_ENDPOINT por el endpoint regional EU o US. Sustituye PROJECT_ID por el ID de tu 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 la CLI de Google Cloud para crear un token de acceso para tu cuenta de Google. Para obtener instrucciones sobre cómo instalar gcloud CLI, consulta Autenticarse en Text-to-Speech.
Restringir el uso de endpoints de API globales
Para ayudar a aplicar el uso de endpoints regionales, usa la restricción de la política de organización constraints/gcp.restrictEndpointUsage para bloquear las solicitudes al endpoint de la API global. Para obtener más información, consulta Restringir el uso de endpoints.