Specifica un endpoint regionale

Text-to-Speech offre endpoint API regionali e multiregionali global, us e eu. Se utilizzi un endpoint regionale, i dati at-rest e in uso rimangono all'interno dei confini regionali o continentali rispettivamente dell'Europa e degli Stati Uniti. Se la località dei tuoi dati deve essere controllata per rispettare i requisiti normativi locali, è importante specificare un endpoint. Non vengono 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 (multi-regione)
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

	UE (multi-regione)	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

Utilizza endpoint regionali

Quando utilizzi un endpoint regionale, assicurati di includere la località us o eu corrispondente nella stringa parent. Consulta la documentazione su Synthesize per saperne di più sulla configurazione del corpo delle richieste di sintesi.

Protocollo

Per eseguire la sintesi vocale utilizzando un endpoint regionale, esegui il comando applicabile nella tabella di seguito per configurare l'endpoint corretto:

Multi-regione	Override dell'endpoint
UE	$ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com
US	$ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com

Da questi endpoint sono disponibili solo le voci Neural2:

Regione singola	Override dell'endpoint
US Central1	$ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com

L'esempio di codice seguente mostra come inviare una 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 Autenticazione 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 Limitazione dell'utilizzo degli endpoint.