Text-to-Speech offre endpoint API multiregionali e regionali global, us e eu.
Se utilizzi un endpoint regionale, i dati non attivi e in uso rimangono
all'interno dei confini regionali o continentali dell'Europa o degli Stati Uniti, rispettivamente. Se la posizione dei tuoi dati deve essere controllata per rispettare i requisiti normativi locali, è importante specificare un endpoint. Non sono state apportate modifiche funzionali al comportamento
dell'API.
Globale
| Nome modello | Globale |
|---|---|
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts) |
|
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts) |
|
| Chirp 3: voci in HD | |
| Chirp 3: voce personalizzata istantanea |
Stati Uniti
| Nome modello | Stati Uniti (multiregionale) |
|---|---|
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts) |
|
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts) |
|
| Chirp 3: voci in HD | |
| Chirp 3: voce personalizzata istantanea |
Europa
| Multiregione EU | Londra, Regno Unito (europe-west2) | Francoforte, Germania (europe-west3) | Eemshaven, Paesi Bassi (europe-west4) | |
|---|---|---|---|---|
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts) |
||||
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts) |
||||
| Chirp 3: voci in HD | ||||
| Chirp 3: voce personalizzata istantanea |
Asia Pacifico
| Tokyo, Giappone (asia-northeast1) | Sydney, Australia (australia-southeast1) | Mumbai, India (asia-south1) | Singapore (asia-southeast1) | Seul, Corea (asia-northeast3) | |
|---|---|---|---|---|---|
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts) |
|||||
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts) |
|||||
| Chirp 3: voci in HD | |||||
| Chirp 3: voce personalizzata istantanea |
Utilizzare endpoint regionali
Quando utilizzi un endpoint regionale, assicurati di includere la località us o eu
corrispondente nella stringa parent. Consulta la documentazione
Synthesize
per ulteriori informazioni sulla configurazione del corpo della richiesta di sintesi.
Protocollo
Per eseguire la sintesi vocale utilizzando un endpoint regionale, esegui il comando applicabile nella tabella seguente per configurare l'endpoint corretto:
| Più regioni | Override dell'endpoint |
|---|---|
| UE | $ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com |
| US | $ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com |
Solo le voci Neural2 sono disponibili da questi endpoint:
| Area geografica singola | Override dell'endpoint |
|---|---|
| US Central1 | $ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com |
Il seguente esempio di codice mostra come inviare un
synthesis request
che mantiene tutti i dati confinati in una regione specificata. Puoi sostituire l'endpoint regionale EU o US con la variabile CLOUD_TTS_ENDPOINT. Sostituisci PROJECT_ID con l'ID progetto.
$ 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
Questo esempio utilizza Google Cloud CLI per creare un token di accesso per il tuo Account Google. Per istruzioni sull'installazione di gcloud CLI, vedi Autenticarsi in Text-to-Speech.
Limita l'utilizzo degli endpoint API globali
Per contribuire a imporre l'utilizzo di endpoint regionali, utilizza il vincolo delle policy dell'organizzazione constraints/gcp.restrictEndpointUsage per bloccare le richieste all'endpoint API globale. Per saperne di più, consulta la pagina
Limitare l'utilizzo degli endpoint.