指定区域端点

Text-to-Speech 提供美国和欧盟区域 API 端点。如果使用区域端点，则静态数据和使用中的数据都将存放在欧洲大陆边界或美国内。如果必须控制数据的位置以符合当地法规的要求，则指定端点很重要。该 API 的行为功能在功能上没有变化。

使用区域端点

使用区域端点时，请务必在 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 端点的请求。如需了解详情，请参阅限制端点使用。