配额和限制

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

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

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

v2 配额适用于 Cloud Translation 基本版,v3 配额适用于 Cloud Translation 高级版。您可以使用 Google Cloud Console 配额页面查看或修改配额。

内容配额

内容配额适用于您通过 translateTextdetectLanguage 方法发送到 Cloud Translation API 的文本字符串。发送到 Cloud Translation API 的所有字符(包括空白字符)都将计入这些配额。如果您同时使用 Cloud Translation 基本版和 Cloud Translation 高级版,则这些配额是累加的。

内容配额 默认
每项目每天 v2 和 v3 常规模型字符数 无限制
每项目每分钟 v2 和 v3 常规模型字符数 600 万个字符
每用户每项目每分钟的 v2 和 v3 常规模型字符数* 600 万个字符

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

Cloud Translation API 针对较小的翻译请求进行了优化。每个请求的建议长度上限为 2K 字符(码位)。单个请求的码位上限是 30K。无论可用配额有多少,Cloud Translation API 都会拒绝大小超过此上限的请求并返回 400 INVALID_ARGUMENT 错误。

请求配额

Cloud Translation 对用户可以向服务发送的请求数设置了配额。

配额 默认
每项目每分钟 v2 和 v3 接收支持语言的请求数 600 次请求
每项目每分钟 v3 请求数 6000 个请求
每用户每项目每分钟 v3 请求数* 无限制
每项目每天 v3 批处理翻译请求总数 无限制

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

适用于除 translateTextdetectLanguagegetSupportedLanguages 方法以外的所有 Cloud Translation 高级版方法调用。

AutoML 配额

对于 Cloud Translation 高级版,您可以使用 AutoML 中的模型来翻译内容。如果您使用自定义模型,则使用量计入单独的一组配额。如需详细了解 AutoML 内容和请求配额,请参阅 AutoML Translation 文档

配额计入

对于 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 高级版限制,这些限制无法更改。

说明 限制
单个批量请求中可以包括的文件数上限 1000 个文件
项目的术语库资源数上限 1000