Guidelines and quotas
Unless otherwise specified, the Amazon Comprehend quotas are per region. You can request an increase to a quota if needed for your applications. For information about service quotas and to request a quota increase, see AWS Service Quotas.
Supported Regions
For a list of AWS Regions where Amazon Comprehend is available, see AWS Regions and Endpoints in the Amazon Web Services General Reference.
General guidelines and quotas
General guidelines and quotas related to Amazon Comprehend processing modes. For more information, see Document processing modes.
Topics
Synchronous operations
All single-document synchronous operations except sentiment analysis, targeted sentiment analysis, and syntax analysis have the following quotas.
| Description | Quota/Guideline |
|---|---|
| Character encoding | UTF-8 |
| Maximum document size | 100 KB |
The maximum document size for sentiment analysis, targeted sentiment analysis, syntax analysis, and the batch synchronous operations is 5 KB.
Amazon Comprehend may store your content to continuously improve the quality
of its analysis models. See the Amazon Comprehend FAQ
Throttling for single transactions
Amazon Comprehend supports up to 20 transactions per second (per region, per account) for synchronous operations. For information about the throttling quotas for each operation, see Amazon Comprehend endpoints and quotas in the Amazon Web Services General Reference.
You may be able to avoid request throttling by using the multiple document operations instead of the single document operations.
Multiple document operations
The BatchDetectDominantLanguage, BatchDetectEntities, BatchDetectKeyPhrases, and BatchDetectSentiment operations have the following quotas.
| Description | Quota/Guideline |
|---|---|
| Documents per request | 25 |
If you plan to send multiple requests per second, consider using the multiple document operations to avoid request throttling. Using multiple document operations, you can send up to 25 documents in each request. For more information about using multiple document operations, see Multiple document synchronous processing.
For more information about throttling quotas, see Amazon Comprehend Quotas in the Amazon Web Services General Reference.
Concurrent active asynchronous jobs
You create new analysis jobs using the Amazon Comprehend console or one of the API_Start* operations.
Each account can have up to 10 concurrent active jobs of a given job type.
| Description | Quota/Guideline |
|---|---|
| Maximum number of concurrent active jobs per job type | 10 |
Asynchronous jobs
Asynchronous analysis jobs that you run using one of the API_Start* operations have the
following quotas.
| Description | Quota/Guideline |
|---|---|
| Maximum size of each document in jobs that detect entities, key phrases, PII, and languages | 1 MB |
| Maximum size of each document in jobs that detect sentiment | 5 KB |
| Total size of all files in batch | 5 GB |
| Maximum number of files, one document per file | 1,000,000 |
Use the asynchronous operations:
-
To analyze more than 25 documents at a time
-
To analyze documents larger than 5,000 bytes for keywords and entities
For more information, see Asynchronous batch processing.
Insights
Targeted sentiment
Targeted sentiment supports only asynchronous analysis jobs. Jobs created with the StartTargetedSentimentDetectionJob operation have the following quotas.
Targeted sentiment detection - inference (StartTargetedSentimentDetectionJob) | |
|---|---|
| Description | Quota/Guideline |
| Supported document formats | UTF-8 |
| Maximum size of each document in a job | 10 KB |
| Maximum size of all documents in a job | 300 MB |
| Maximum number of files, one document per file | 30,000 |
| Maximum number of lines, one document per line (for all files in a request) | 30,000 |
Language detection
The BatchDetectDominantLanguage, DetectDominantLanguage operations and asynchronous jobs started with the StartDominantLanguageDetectionJob operation have the following limitations:
-
They don't support phonetic language detection. For example, they will not detect "arigato" as Japanese nor "nihao" as Chinese.
-
They may have trouble distinguishing close language pairs, such as Indonesian and Malay; or Bosnian, Croatian, and Serbian.
-
For best results the input text should be at least 20 characters long.
Events
Events detection jobs created with the StartEventsDetectionJob operation have the following quotas.
| Description | Quotas |
|---|---|
| Character encoding | UTF-8 |
| Total size of all files in a job | 50 MB |
| Maximum size of each document in a job | 10 KB |
| Maximum number of files, one document per file | 5,000 |
| Maximum number of lines, one document per line (for all files in request) | 5,000 |
Topic modeling
Topic detection jobs created with the StartTopicsDetectionJob operation have the following quotas.
| Description | Quota/Guideline |
|---|---|
| Character encoding | UTF-8 |
| Maximum number of topics to return | 100 |
| Maximum total size of all files in request | 5 GB |
| Minimum total size of all files in request | 500 bytes |
| Maximum file size for one file, one document per file | 100 MB |
| Maximum number of files, one document per file | 1,000,000 |
| Maximum number of lines, one document per line (for all files in request) | 1,000,000 |
For best results, you should include at least 1,000 input documents.
Custom analysis
Specific guidelines and quotas for Amazon Comprehend custom analysis. For more information, see Document processing.
Inputs for custom analysis
Document sizes for real-time analysis
For all input document types, the input file maximum is one page, with no more than 10,000 characters.
The following table shows the maximum file sizes for input documents.
| File type | Maximum size (API) | Maximum size (console) |
|---|---|---|
| UTF-8 text documents | 10 KB | 10 KB |
| PDF documents | 10 MB | 5 MB |
| Word documents | 10 MB | 5 MB |
| Image files | 10 MB | 5 MB |
| Textract output files | 1 MB | n/a |
Document sizes for asynchronous analysis jobs
The following tables show the maximum file sizes for each type of input document.
Guidelines that apply when all the input files are plain text | |
|---|---|
| Description | Quota/Guideline |
| Maximum file size for one document per file format (Custom classification) | 1 byte–10 MB |
| Document size (Custom entity recognition) | 1 byte–1 MB |
| Maximum number of files, one document per file | 1,000,000 |
| Maximum number of lines, one document per line (for all files in request) | 1,000,000 |
| Document corpus size (all docs in plaintext combined) | 1 byte–5 GB |
The following table lists the guidelines semi-structured input documents.
Guidelines that apply to semi-structured input documents | |
|---|---|
| Description | Quota/Guideline |
| Document size (PDF) | 1 byte–50 MB |
| Document size (Docx) | 1 byte–5 MB |
| Image size (JPG or PNG) | 1 byte–10 MB |
| Image size (TIFF) | 1 byte–10 MB. Maximum one page. |
| Maximum number of files | 500 |
| Maximum number of pages for a PDF or Docx file | 100 |
| Document corpus size after text extraction (plaintext, all files combined) | 1 byte–5 GB |
Document classification
The following tables list the quotas for:
-
Classifier training jobs started with the CreateDocumentClassifier operation.
Asynchronous document classification jobs started with the StartDocumentClassificationJob operation.
-
Synchronous document classification requests using the ClassifyDocument operation.
General | |
|---|---|
| Description | Quota/Guideline |
| Character encoding | UTF-8 |
| Maximum number of classes (multi-class mode) | 1,000 |
| Maximum number of classes (multi-label mode) | 100 |
| Maximum length of class name | 5,000 characters |
| Minimum number of training documents per class (multi-class mode) | 50 |
| Minimum number of training documents per class (multi-label mode) | 10 |
| Total size of all files in training job | 5 GB |
| Total size of all files in asynchronous job | 5 GB |
| Maximum file size for one file, one document per file | 10 MB |
| Maximum number of files, one document per file | 1,000,000 |
| Maximum number of lines, one document per line (for all files in request) | 1,000,000 |
| Maximum number of documents per synchronous request | 1 |
| Maximum number of augmented manifest files for training a custom classifier | 5 |
| Maximum number of attribute names for each augmented manifest file | 5 |
| Maximum length of attribute name | 63 characters |
Real-time analysis | |
|---|---|
| Description | Quota/Guideline |
| Maximum number of inference units per region for each account | 100 |
| Maximum number of inference units per endpoint | 10 |
| Maximum throughput per inference unit (characters) | 100/second |
| Maximum throughput per inference unit (documents) | 2/second |
Entity recognition
The following tables list the quotas for:
Entity recognizer training jobs started with the CreateEntityRecognizer operation.
Asynchronous entity recognition jobs started with the StartEntitiesDetectionJob operation.
Synchronous entity recognition requests using the DetectEntities operation.
Plaintext entity recognition - training (CreateEntityRecognizer) | |
|---|---|
| Description | Quota/Guideline |
| Number of entities per model/custom entity recognizer | 1–25 |
| Document size (UTF-8) | 1–5,000 byte |
| Number of documents (see Plain-text annotations) | 3–120,000 |
| Document corpus size (all docs in plaintext combined) | 5 KB - 100 MB |
| Minimum number of annotations per entity | 25 |
| Number of items in entity list | 1–1 million |
| Length of individual entry (post-strip) in entry list | 1–5,000 |
| Entity list corpus size (all docs in plaintext combined) | 5 KB –100 MB |
PDF or Word text entity recognition - training (CreateEntityRecognizer) | |
|---|---|
| Description | Quota/Guideline |
| Number of entities per model/custom entity recognizer | 1–25 |
| Maximum annotation file size (UTF-8 JSON) | 5 MB |
| Number of documents | 250–10,000 |
| Document corpus size (all docs in plaintext combined) | 5 KB–1 GB |
| Minimum number of annotations per entity | 100 |
Augmented manifest files | |
|---|---|
| Description | Quota/Guideline |
| Maximum number of augmented manifest files for training a custom entity recognizer | 5 |
| Maximum number of attribute names for each augmented manifest file | 5 |
| Maximum length of attribute name | 63 characters |
Entity recognition for plaintext files - inference (StartEntitiesDetectionJob) | |
|---|---|
| Description | Quota/Guideline |
| Document size (UTF-8) | 1 byte–1 MB |
| Maximum number of files, one document per file | 1,000,000 |
| Maximum number of lines, one document per line (for all files in request) | 1,000,000 |
| Document corpus size (all docs in plaintext combined) | 1 byte–5 GB |
Entity recognition for image, PDF, or Word files - inference (StartEntitiesDetectionJob) | |
|---|---|
| Description | Quota/Guideline |
| Image size (JPG or PNG) | 1 byte–10 MB |
| Image size (TIFF) | 1 byte–10 MB. Maximum one page. |
| Document size (PDF) | 1 byte–50 MB |
| Document size (Docx) | 1 byte–5 MB |
| Document size (UTF-8) | 1 byte–1 MB |
| Maximum number of files, one document per file (one document per line not allowed for image files or PDF/Word documents) | 500 |
| Maximum number of pages for a PDF or Docx file | 100 |
| Document corpus size after text extraction (plaintext, all files combined) | 1 byte–5 GB |
For more information about limits for images, see Hard Limits in Amazon Textract
Real-time analysis | |
|---|---|
| Description | Quota/Guideline |
| Maximum number of inference units per account | 100 |
| Maximum number of inference units per endpoint | 10 |
| Maximum throughput per inference unit (characters) | 100/second |
| Maximum throughput per inference unit (documents) | 2/second |
| Maximum number of documents per synchronous request | 1 |
