Text-to-Speech ofrece extremos de API regionales y multirregionales de global, us y eu.
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 |
|---|---|
Texto a voz de Gemini 2.5 Flash (gemini-2.5-flash-tts) |
|
Texto a voz 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 |
|---|---|
Texto a voz de Gemini 2.5 Flash (gemini-2.5-flash-tts) |
|
Texto a voz 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) | |
|---|---|---|---|---|
Texto a voz de Gemini 2.5 Flash (gemini-2.5-flash-tts) |
||||
Texto a voz 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) | |
|---|---|---|---|---|---|
Texto a voz de Gemini 2.5 Flash (gemini-2.5-flash-tts) |
|||||
Texto a voz 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 string parent. Consulta la documentación de Synthesize para obtener más información sobre la configuración del cuerpo de la solicitud de sintetizar.
Protocolo
Para realizar la síntesis de texto a voz con un extremo regional, ejecuta el comando aplicable en la siguiente tabla a fin de configurar el extremo correcto:
| Multirregión | Anulación de extremos |
|---|---|
| UE | $ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com |
| US | $ 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 un synthesis request que mantiene 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 para 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 el uso de extremos regionales, usa la restricción de política de la organización constraints/gcp.restrictEndpointUsage para bloquear las solicitudes al extremo de API global. Para obtener más información, consulta Cómo restringir el uso de extremos.