Cloud Translation 对请求的内容大小和用户可以发送的请求数设有配额。配额可以保护 Google Cloud 用户群体,防止使用量意外激增。您也可以降低配额来控制费用并防止过度使用。
如果您超出配额,Cloud Translation 将返回 403
错误。如果您超出每日配额,错误消息会显示 Daily Limit Exceeded
;如果超出每分钟配额,则显示 User Rate Limit Exceeded
。
每日配额会在美国太平洋时间零点重置,这意味着新的配额可能需要长达 24 小时才能生效。
设置用量配额
默认情况下,您每天可以发送的字符数没有限制。如果您设置了预算,则建议您监控每日使用量,并根据您计划的支出调整配额。
您可以使用 Google Cloud Console 配额页面修改配额。v2 配额适用于 Cloud Translation 基本版,v3 配额适用于 Cloud Translation 高级版。
内容配额
内容配额适用于您通过 translateText
、detectLanguage
和 translateDocument
方法(同步请求)向 Cloud Translation API 发送的文本字符串和文档。发送到 Cloud Translation API 的所有字符(包括空白字符)都将计入这些配额。如果您同时使用 Cloud Translation 基本版和 Cloud Translation 高级版,则这些配额是累加的。
内容配额 | 默认 |
---|---|
每个项目每天的 v2 和 v3 常规模型字符数 | 无限制 |
每个项目每分钟的 v2 和 v3 常规模型字符数 | 600 万个字符 |
每位用户每个项目每分钟的 v2 和 v3 常规模型字符数* | 600 万个字符 |
每个项目每分钟的 v3 文档翻译页面† | 2400 页 |
每个用户每个项目每分钟的 v3 文档翻译页面数量† | 2400 页 |
* 每位用户的配额适用于使用客户端应用的最终用户每分钟可以发出的请求数。如果您使用服务帐号,系统会将对应服务帐号视为配额限制的用户。如果您使用 Cloud Translation 基本版和 API 密钥,Cloud Translation 会使用客户端的 IP 地址来实施此限制。
† 文档翻译页面配额将计入 Cloud Translation 的字符配额。例如,如果您每分钟最多可发送 2400 页,则文档中的字符数也不能超过 600 万个字符。对于 XLSX 文件,系统仅应用字符配额(而非页面配额)。Cloud Translation 基本版不支持文档翻译。
Cloud Translation API 为翻译较小的请求进行了优化。每个请求的建议长度上限为 5K 字符(码位)。您包含的字符越多,响应延迟时间就越长。 对于 Cloud Translation 高级版,单个请求的码位上限是 30K。Cloud Translation 基本版的请求大小上限为 100K 字节。 另一种方法是使用批量翻译作为长时间运行的操作为每个请求发送更多内容。
无论可用配额有多少,Cloud Translation API 都会拒绝大小超过此上限的请求并返回 400 INVALID_ARGUMENT
错误。
请求配额
Cloud Translation 对用户可以向服务发送的请求数设置了配额。
配额 | 默认 |
---|---|
每个项目每分钟收到受支持语言的请求数(v2 与 v3 合并) | 600 次请求 |
每个项目每分钟的 v2 请求数† | 300,000 个请求 |
每位用户每个项目每分钟的 v2 请求数*† | 不超过每个项目的 v2 限制 |
每个项目每分钟的 v3 请求数† | 6000 个请求 |
每位用户每个项目每分钟的 v3 请求数*† | 不超过每个项目的 v3 限制 |
每个项目每天 v3 批量翻译请求(文本和文档)的总数 | 无限制 |
* 每位用户的配额适用于使用客户端应用的最终用户每分钟可以发出的请求数。如果您使用服务帐号,系统会将对应服务帐号视为配额限制的用户。如果您使用 Cloud Translation 基本版和 API 密钥,Cloud Translation 会使用客户端的 IP 地址来实施此限制。
† 适用于除 translateText
、detectLanguage
、translateDocument
和 getSupportedLanguages
方法以外的所有 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 高级版限制,这些限制无法更改。
说明 | 限制 |
---|---|
单个批量请求中可以包括的文件数上限 | 100 个文件 |
项目的术语库资源数上限 | 1 万 |