This document lists the quotas and limits that apply to Cloud Natural Language.
A quota restricts how much of a particular shared Google Cloud resource your Google Cloud project can use, including hardware, software, and network components.
Quotas are part of a system that does the following:
- Monitors your use or consumption of Google Cloud products and services.
- Restricts your consumption of those resources for reasons including ensuring fairness and reducing spikes in usage.
- Maintains configurations that automatically enforce prescribed restrictions.
- Provides a means to make or request changes to the quota.
When a quota is exceeded, in most cases, the system immediately blocks access to the relevant Google resource, and the task that you're trying to perform fails. In most cases, quotas apply to each Google Cloud project and are shared across all applications and IP addresses that use that Google Cloud project.
To increase or decrease most quotas, use the Google Cloud console. For more information, see Request a higher quota limit.
There are also limits on Natural Language resources. These limits are unrelated to the quota system. Limits cannot be changed unless otherwise stated.
Language restrictions
The Natural Language API currently supports only the languages listed in Language Support.
Content quotas
Content to the Natural Language API is provided as a text string. The Natural Language API processes this text into a series of tokens, which roughly correspond to word boundaries. All Natural Language API features (Sentiment Analysis, Entity Extraction, and Syntactic Analysis) use these tokens as the building blocks for performing analysis on the provided text.
The API contains the following quotas on the size of this content for each request:
| Content Quota | Value | Overflow Result |
|---|---|---|
| Text Content | 1,000,000 bytes | API Error |
| Token Quota | 100,000 tokens | Ignored |
| Entity Mentions | 5,000* | Ignored |
Attempting to process content in excess of the Text Content quota will produce an error. Attempting to process tokens in excess of the Token Quota will not produce an error, but any tokens over that quota will be ignored.
Note that byte counts may not reflect character counts, depending on the encoding used within the text content.
* The Entity Mentions quota includes not only returned mentions within the
document, but any noun references to those entities, including pronouns.
Note that those pronouns are not returned directly in the mentions field,
though they do count against the quota.
Request quotas
The current API usage quotas for the Cloud Natural Language API are as follows (and are subject to change):
| Type of Quota | Usage Quota |
|---|---|
| Requests per minute | 600 |
| Requests per day | 800,000 |