指定区域端点

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：高清语音
Chirp 3：即时自定义语音

美国

模型名称	美国多区域
Gemini 2.5 Flash TTS (gemini-2.5-flash-tts)
Gemini 2.5 Flash TTS (gemini-2.5-pro-tts)
Chirp 3：高清语音
Chirp 3：即时自定义语音

欧洲

	欧盟多区域	英国伦敦 (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：高清语音
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：高清语音
Chirp 3：即时自定义语音

使用区域端点

使用区域端点时，请务必在 parent 字符串中包含匹配的 us 或 eu 位置。如需详细了解如何配置合成请求正文，请参阅 Synthesize 文档。

协议

要使用区域端点执行文字转语音合成，请运行下表中的相应命令以配置正确的端点：

多区域	端点替换
欧盟	$ 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 以将所有数据都限于指定的区域中。可以使用 EU 或 US 区域端点替换 CLOUD_TTS_ENDPOINT 变量。 将 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 端点的请求。如需了解详情，请参阅限制端点用量。