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 persyaratan peraturan setempat, maka menentukan endpoint sangat penting. Tidak ada perubahan fungsional pada perilaku API.
Global
| Nama model | Multi-region AS |
|---|---|
TTS Gemini 2.5 Flash (gemini-2.5-flash-tts) |
|
TTS Gemini 2.5 Flash (gemini-2.5-pro-tts) |
|
| Chirp 3: Suara HD | |
| Chirp 3: Suara Kustom Instan |
Amerika Serikat
| Nama model | Multi-region AS |
|---|---|
TTS Gemini 2.5 Flash (gemini-2.5-flash-tts) |
|
TTS Gemini 2.5 Flash (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) | |
|---|---|---|---|---|
TTS Gemini 2.5 Flash (gemini-2.5-flash-tts) |
||||
TTS Gemini 2.5 Flash (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) | |
|---|---|---|---|---|---|
TTS Gemini 2.5 Flash (gemini-2.5-flash-tts) |
|||||
TTS Gemini 2.5 Flash (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.
Protocol
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 - EU | $ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com |
| US | $ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com |
Hanya suara Neural2 yang tersedia dari endpoint berikut:
| Satu region | Penggantian endpoint |
|---|---|
| US Central1 | $ 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.