リージョン エンドポイントを指定する

Text-to-Speech には、global、us、eu のマルチリージョンおよびリージョン API エンドポイントが用意されています。リージョン エンドポイントを使用する場合、保存データと使用中のデータは、それぞれヨーロッパまたは米国のリージョン境界内にとどまります。現地の規制要件に合わせてデータのロケーションを制御する必要がある場合は、エンドポイントの指定が重要となります。API の動作に対する機能面の変更はありません。

グローバル

モデル名	グローバル
Gemini 2.5 Flash TTS（gemini-2.5-flash-tts）
Gemini 2.5 Flash TTS（gemini-2.5-pro-tts）
Chirp 3: HD 音声
Chirp 3: インスタント カスタム音声

米国

モデル名	米国（マルチリージョン）
Gemini 2.5 Flash TTS（gemini-2.5-flash-tts）
Gemini 2.5 Flash TTS（gemini-2.5-pro-tts）
Chirp 3: HD 音声
Chirp 3: インスタント カスタム音声

ヨーロッパ

	EU（マルチリージョン）	ロンドン、英国（europe-west2）	フランクフルト、ドイツ（europe-west3）	オランダ、エームスハーヴェン（europe-west4）
Gemini 2.5 Flash TTS（gemini-2.5-flash-tts）
Gemini 2.5 Flash TTS（gemini-2.5-pro-tts）
Chirp 3: HD 音声
Chirp 3: インスタント カスタム音声

アジア太平洋

	東京、日本（asia-northeast1）	シドニー、オーストラリア（australia-southeast1）	ムンバイ、インド（asia-south1）	シンガポール（asia-southeast1）	ソウル、韓国（asia-northeast3）
Gemini 2.5 Flash TTS（gemini-2.5-flash-tts）
Gemini 2.5 Flash TTS（gemini-2.5-pro-tts）
Chirp 3: HD 音声
Chirp 3: インスタント カスタム音声

リージョン エンドポイントを使用する

リージョン エンドポイントを使用する場合は、一致する us または eu のロケーションを parent 文字列に含める必要があります。合成リクエストの本文の構成については、Synthesize のドキュメントをご覧ください。

プロトコル

リージョン エンドポイントを使用してテキスト読み上げ合成を実行するには、次の表の該当するコマンドを実行して、適切なエンドポイントを構成します。

マルチリージョン	エンドポイントのオーバーライド
EU	$ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com
米国	$ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com

Neural2 音声を使用できるのは、以下のエンドポイントに限られます。

シングル リージョン	エンドポイントのオーバーライド
us-central1	$ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com

次のコードサンプルは、すべてのデータを特定のリージョンに制限する synthesis request を送信する方法を示しています。CLOUD_TTS_ENDPOINT 変数は、EU または US リージョン エンドポイントで置き換えることができます。PROJECT_ID は、実際のプロジェクト ID に置き換えます。

$ 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

この例では、Google Cloud CLI を使用して、Google アカウントのアクセス トークンを作成します。gcloud CLI のインストール手順については、Text-to-Speech に対する認証を行うをご覧ください。

グローバル API エンドポイントの使用を制限する

リージョナル エンドポイントの使用を強制するには、constraints/gcp.restrictEndpointUsage 組織のポリシーの制約を使用して、グローバル API エンドポイントへのリクエストをブロックします。詳細については、エンドポイントの使用の制限をご覧ください。