配额和限制

Cloud Translation 对请求的内容大小和用户可以发送的请求数设有配额。配额可以保护 Google Cloud 用户群体，防止使用量意外激增。您也可以降低配额来控制费用并防止过度使用。

如果您超出配额，Cloud Translation 将返回 403 错误。如果您超出每日配额，错误消息会显示 Daily Limit Exceeded；如果超出每分钟配额，则显示 User Rate Limit Exceeded。

每日配额会在美国太平洋时间零点重置，这意味着新的配额可能需要长达 24 小时才能生效。

设置用量配额

默认情况下，您每天可以发送的字符数没有限制。如果您设置了预算，则建议您监控每日使用量，并根据您计划的支出调整配额。

您可以使用 Google Cloud 控制台配额页面修改配额。v2 配额适用于 Cloud Translation 基本版，v3 配额适用于 Cloud Translation 高级版。

内容配额

内容配额适用于 translateText、detectLanguage 和 translateDocument 方法的同步请求。对于异步请求（例如批量文本翻译），仅请求配额适用。

发送到 Cloud Translation API 的所有字符（包括空白字符）都将计入内容配额。如果您同时使用 Cloud Translation 基本版和 Cloud Translation 高级版，则这些配额都是累计配额。

对于文本翻译，自定义模型配额会单独计算，不计入常规模型配额。不过，一个项目每天请求的自定义模型数量是有上限的。

每位用户的配额适用于使用客户端应用的最终用户每分钟可以发出的请求数。为了实施配额限制，当您使用服务账号时，系统将对应服务账号视为“用户”。如果您使用 Cloud Translation 基本版和 API 密钥，Cloud Translation 会使用客户端的 IP 地址来实施此限制。

每个请求的内容限制

Cloud Translation API 为翻译较小的请求进行了优化。每个请求的建议长度上限为 5K 字符（码位）。您包含的字符越多，响应延迟时间就越长。 对于 Cloud Translation 高级版，单个请求的码位上限是 30K。Cloud Translation 基本版的请求大小上限为 100K 字节。 另一种方法是使用批量翻译作为长时间运行的操作为每个请求发送更多内容。

无论可用配额有多少，Cloud Translation API 都会拒绝大小超过此上限的请求并返回 400 INVALID_ARGUMENT 错误。

请求配额

Cloud Translation 对用户可以向服务发送的请求数设置了配额。 这些配额适用于所有 Cloud Translation 方法调用，但 translateDocument 和 getSupportedLanguages 方法除外，它们具有自己的请求或内容配额。

自定义模型配额会单独计算，不计入其他 v3 请求配额。

每位用户的配额适用于使用客户端应用的最终用户每分钟可以发出的请求数。为了实施配额限制，当您使用服务账号时，系统将对应服务账号视为“用户”。如果您使用 Cloud Translation 基本版和 API 密钥，Cloud Translation 会使用客户端的 IP 地址来实施此限制。

配额计入

对于 Cloud Translation 基本版，内容和请求配额计入发出请求的项目，此项目由请求中使用的密钥确定。

对于 Cloud Translation 高级版，内容配额计入与请求中的模型关联的项目，请求配额计入发出请求的项目。

例如，在以下翻译文本请求中，请求计入 project-id-1 的配额，因为此请求来自于 project-id-1；内容配额计入 project-id-2，因为此请求使用的是该项目中的模型。

POST https://translation.googleapis.com/v3/projects/project-id-1/locations/us-central1:translateText
{
  "Model":"projects/project-id-2/locations/us-central1/models/model-id",
  "sourceLanguageCode": "en",
  "targetLanguageCode": "ru",
  "contents": ["Dr. Watson, please discard your trash."]
}

Cloud Translation 高级版限制

下表介绍 Cloud Translation 高级版限制，这些限制无法更改。

自适应翻译