配额和限制

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

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

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

设置用量配额

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

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

内容配额

内容配额适用于 translateTextdetectLanguagetranslateDocument 方法的同步请求。对于异步请求(例如批量文本翻译),仅请求配额适用。

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

对于文本翻译,自定义模型配额会单独计算,不计入常规模型配额。

配额 默认
每个项目每天发送至通用模型的字符(v2 和 v3) 无限制
每个项目每分钟发送给通用模型的字符(v2 和 v3) 6000000
每位用户每个项目每分钟发送给通用模型的字符(v2 和 v3) 6000000
每个项目每分钟针对音译发送的字符 (v3) 100,000(也计入每个项目每分钟发送给通用模型的字符数配额)
每个项目每分钟针对拼音化发送的字符 (v3) 100000
每个项目每分钟发送给自定义模型的字符 (v3) 100000
每位用户每个项目每分钟发送给自定义模型的字符 (v3) 不超过项目限额
对于文档翻译,每个项目每分钟发送的页面数 (v3) 2400
对于文档翻译,每个用户每个项目每分钟发送的页面数 (v3) 2400

每位用户的配额适用于使用客户端应用的最终用户每分钟可以发出的请求数。为了实施配额限制,当您使用服务账号时,系统将对应服务账号视为“用户”。如果您使用 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 方法调用,但 translateDocumentgetSupportedLanguages 方法除外,它们具有自己的请求或内容配额。

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

配额 默认
每个项目每分钟收到受支持语言的请求数(v2v3 合并) 600
每个项目每分钟的 v2 请求数 300000
每位用户每个项目每分钟的 v2 请求数 不超过 v2 项目限制
每个项目每分钟的 v3 请求数 6000
每个项目每分钟的 v3 拼音化请求数 6000
每位用户每分钟的 v3 请求数 不超过 v3 项目限制
每个项目每天的 v3 批量翻译请求数(文本和文档) 无限制
每个项目每天的 v3 自定义模型翻译请求数 无限制
每个项目每分钟的 v3 自定义模型翻译请求数 600
每个项目每天的 v3 自定义模型批量翻译请求数 无限制
每个项目每分钟的 v3 模型创建请求数 10
每个项目的 v3 并发模型创建请求数 2

每位用户的配额适用于使用客户端应用的最终用户每分钟可以发出的请求数。为了实施配额限制,当您使用服务账号时,系统将对应服务账号视为“用户”。如果您使用 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 高级版限制,这些限制无法更改。

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

自适应翻译

说明 限制
您可以导入的句对数上限 10,000(Google Cloud 控制台)
30,000 (API)
每个请求中可以发送的字符数上限 3,000
每个请求中自适应翻译的输出字符数上限 语言为 3,000(任何超出此限制的文本都会被丢弃)