Menentukan endpoint regional

Text-to-Speech menawarkan endpoint API regional dan multiregional global, us, eu. Jika Anda menggunakan endpoint regional, data dalam penyimpanan dan yang sedang digunakan akan tetap berada dalam batas regional atau kontinental Eropa atau Amerika Serikat. Jika lokasi data Anda harus dikontrol untuk mematuhi ketentuan regulasi setempat, itu artinya penentuan endpoint sangat penting. Tidak ada perubahan fungsional pada perilaku API.

Global

Nama model Multi-region AS
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts)
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts)
Chirp 3: Suara HD
Chirp 3: Suara Kustom Instan

Amerika Serikat

Nama model Multi-region AS
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts)
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts)
Chirp 3: Suara HD
Chirp 3: Suara Kustom Instan

Eropa

Multi-region Uni Eropa London, Inggris Raya (europe-west2) Frankfurt, Jerman (europe-west3) Eemshaven, Belanda (europe-west4)
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts)
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts)
Chirp 3: Suara HD
Chirp 3: Suara Kustom Instan

Asia Pasifik

Tokyo, Jepang (asia-northeast1) Sydney, Australia (australia-southeast1) Mumbai, India (asia-south1) Singapura (asia-southeast1) Seoul, Korea (asia-northeast3)
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts)
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts)
Chirp 3: Suara HD
Chirp 3: Suara Kustom Instan

Menggunakan endpoint regional

Saat Anda menggunakan endpoint regional, pastikan untuk menyertakan lokasi us atau eu yang cocok dalam string parent. Lihat dokumentasi Synthesize untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi isi permintaan sintesis.

Protokol

Untuk melakukan sintesis text to speech menggunakan endpoint regional, jalankan perintah yang berlaku pada tabel di bawah untuk mengonfigurasi endpoint yang benar:

Multi-region Penggantian endpoint
Uni Eropa $ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com
AS $ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com

Hanya suara Neural2 yang tersedia dari endpoint berikut:

Satu region Penggantian endpoint
Central1 AS $ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com

Contoh kode berikut menunjukkan cara mengirim synthesis request yang menyimpan semua data hanya untuk region yang ditentukan. Anda dapat mengganti endpoint regional EU atau US untuk variabel CLOUD_TTS_ENDPOINT. Ganti PROJECT_ID dengan project ID Anda.

$ 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

Contoh ini menggunakan Google Cloud CLI untuk membuat token akses bagi Akun Google Anda. Untuk mengetahui petunjuk tentang cara menginstal gcloud CLI, lihat Mengautentikasi ke Text-to-Speech.

Membatasi penggunaan endpoint API global

Untuk membantu menerapkan penggunaan endpoint regional, gunakan batasan kebijakan organisasi constraints/gcp.restrictEndpointUsage untuk memblokir permintaan ke endpoint API global. Untuk mengetahui informasi selengkapnya, lihat Membatasi penggunaan endpoint.