Overview
When using features of the Language service, keep the following information in mind:
- Pricing is independent of data or rate limits. Pricing is based on the number of text records you send to the API, and is subject to your Language resource's pricing details.
- A text record is measured as 1000 characters. The Next set of 1000 characters is a separate text record, even if they are part of the same doc array.
- Data and rate limits are based on the number of documents you send to the API. If you need to analyze larger documents than the limit allows, you can break the text into smaller chunks of text before sending them to the API.
- A document is a single string of text characters.
Maximum Characters Per Document
The following limit specifies the maximum number of characters that can be in a single document.
| Feature | Value |
|---|---|
| Text Analytics for health | 125,000 characters as measured by StringInfo.LengthInTextElements. |
| All other preconfigured features (synchronous) | 5,120 as measured by StringInfo.LengthInTextElements. If you need to submit larger documents, consider using the feature asynchronously. |
| All other preconfigured features (asynchronous) | 125,000 characters across all submitted documents, as measured by StringInfo.LengthInTextElements (maximum of 25 documents). |
If a document exceeds the character limit, the API behaves differently depending on how you're sending requests.
- Synchronously sent requests: The API doesn't process documents that exceed the maximum size, and returns an invalid document error for it. If an API request has multiple documents, the API continues processing them if they are within the character limit.
- Asynchronously sent requests: The API rejects the entire request and returns a
400 bad requesterror if any document within it exceeds the maximum size.
Maximum Request Size
The following limit specifies the maximum size of documents contained in the entire request.
| Feature | Value |
|---|---|
| All preconfigured features | 1 MB |
Maximum Documents Per Request
Exceeding the following document limits generates an HTTP 400 error code.
When sending asynchronous API requests, you can send a maximum of 25 documents per request.
| Feature | Max Documents Per Request |
|---|---|
| Text Analytics for health | 25 for the web-based API, 1000 for the container. (125,000 characters in total) |
Rate Limits
| Tier | Requests per minute |
|---|---|
| Single | 1000 |
| Multi-service | 1000 |
Service Limits
| Language Resources Per Region | Language Resources Per Resource Group | Resource groups per subscription ID |
|---|---|---|
| 100 | 800 | 980 |
Throttling Limits
The following throttling limits apply to all requests combined per Language Resource. Throttling will cancel requests until the minute is exhausted.
| Tier | Throttle Limit |
|---|---|
| S1 | 1000/min |
| Container | 300/min |