This document contains current API restrictions and usage quotas on use of the Translation API. This page is updated when there are changes to these restrictions and usage quotas.
These quotas apply to each Translation API developer project and each user, and are shared across all applications and API versions used by a given developer project.
You can edit your quotas up to their maximum values by using the Google Cloud Platform Dashboard. To request an increase above the maximum for a quota, submit a request from the Google Cloud Platform Console page.
Content is provided as text strings to the Translation API. Both pricing and usage are based on character count. All characters sent to the Translation API count towards these quotas, including whitespace characters.
Translation API is optimized for translation of short
requests. The recommended maximum length for each request is 2K
The Translation API rejects very large requests and yields a
400 INVALID_ARGUMENT error) regardless of the available quota.
Character-based quota applies to the
detectLanguage methods. The hard limit for requests is 30K
Unicode characters (code points).
|Content Quota||Default||Maximum||Duration||Applies to|
|v2 and v3 Characters per day||1 billion||unlimited||day||project|
|v2 and v3 Characters per 100 seconds per project||1,000,000 characters||10,000,000 characters||100 seconds||project|
|v2 and v3 Characters per 100 seconds per project per user||100,000 characters||10,000,000 characters||100 seconds||project and user|
If you exceed your quota, Translation v2 returns a
The error message says
Daily Limit Exceeded if you exceeded the daily
User Rate Limit Exceeded if you exceeded either of the
"Characters per 100 seconds" quotas.
To view or change usage limits for your project, or to request an increase to your quota, do the following:
- If you don't already have a billing account for your project, then create one.
- Visit the Enabled APIs page of the API library in the GCP Console, and select an API from the list.
- To view and change quota-related settings, select Quotas. To view usage statistics, select Usage.
In addition to the content quotas shown above, Cloud Translation enforces quotas on the usage of the API.
Discover supported languages requests
For Cloud Translation v2 and v3beta1, there is a limit on how often you can request the list of supported languages for translation.
This quota does not apply to text sent for translation. It applies only to requests for the list of supported languages.
|v2 and v3 requests for the list of supported languages||1000 requests||1000 requests||100 seconds||project|
For Cloud Translation v3beta1, there is a limit to the number of requests
you can make. This quota applies to all v3beta1 method calls except
getSupportedLanguages, which are covered
v2 and v3 Characters and
v2 and v3 Requests for the list of supported
languages per 100 seconds quotas, respectively (see above).
This quota does not apply to requests sent to Cloud Translation v2.
|Activity||Default quota||Applies to|
|API requests per project||6000||project|
|API requests per project per user||unlimited||project and user|