Limiti dei dati e di velocità per l'API Analisi del testoData and rate limits for the Text Analytics API

Usare questo articolo per informazioni sui limiti di dimensioni e velocità per l'invio dei dati all'API Analisi del testo.Use this article to find the limits for the size, and rates that you can send data to Text Analytics API. Si noti che i prezzi non sono interessati dai limiti dei dati o dai limiti di velocità.Note that pricing is not affected by the data limits or rate limits. I prezzi sono soggetti ai Dettagli sui prezzidella risorsa analisi del testo.Pricing is subject to your Text Analytics resource's pricing details.

Limiti dei datiData limits

Nota

  • Se è necessario analizzare documenti di dimensioni maggiori rispetto al limite consentito, è possibile suddividere il testo in blocchi di testo più piccoli prima di inviarli all'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.
  • Un documento è costituito da una singola stringa di caratteri di testo.A document is a single string of text characters.
LimiteLimit valoreValue
Dimensioni massime di un singolo documentoMaximum size of a single document 5.120 caratteri misurati in base a StringInfo.LengthInTextElements.5,120 characters as measured by StringInfo.LengthInTextElements. Si applica anche ad Analisi del testo per la sanità.Also applies to Text Analytics for health.
Dimensioni massime di un singolo documento (endpoint /analyze)Maximum size of a single document (/analyze endpoint) 125.000 caratteri misurati in base a StringInfo.LengthInTextElements.125K characters as measured by StringInfo.LengthInTextElements. Non si applica ad Analisi del testo per la sanità.Does not apply to Text Analytics for health.
Dimensioni massime dell'intera richiestaMaximum size of entire request 1 MB.1 MB. Si applica anche ad Analisi del testo per la sanità.Also applies to Text Analytics for health.

Se un documento supera il limite di caratteri, l'API avrà un comportamento diverso a seconda dell'endpoint in uso:If a document exceeds the character limit, the API will behave differently depending on the endpoint you're using:

  • Endpoint /analyze:/analyze endpoint:
    • L'API rifiuterà l'intera richiesta e restituirà un errore 400 bad request se un documento al suo interno supera le dimensione massime.The API will reject the entire request and return a 400 bad request error if any document within it exceeds the maximum size.
  • Tutti gli altri endpoint:All other endpoints:
    • L'API non elaborerà un documento che supera le dimensioni massime e restituirà un errore di documento non valido.The API won't process a document that exceeds the maximum size, and will return an invalid document error for it. Se una richiesta API include più documenti, l'API continuerà a elaborarli se rispettano il limite di caratteri.If an API request has multiple documents, the API will continue processing them if they are within the character limit.

Il numero massimo di documenti che è possibile inviare in una singola richiesta dipende dalla versione dell'API e dalla funzionalità in uso, come descritto nella tabella seguente.The maximum number of documents you can send in a single request will depend on the API version and feature you're using, which is described in the table below.

I limiti seguenti si applicano all'API v3 corrente.The following limits are for the current v3 API. Il superamento dei limiti indicati di seguito provocherà un codice errore HTTP 400.Exceeding the limits below will generate an HTTP 400 error code.

FunzionalitàFeature Numero massimo di documenti per richiestaMax Documents Per Request
Rilevamento linguaLanguage Detection 10001000
Analisi del sentimentSentiment Analysis 1010
Opinion miningOpinion Mining 1010
Estrazione frasi chiaveKey Phrase Extraction 1010
Riconoscimento di entità denominateNamed Entity Recognition 55
Collegamento delle entitàEntity Linking 55
Analisi del testo per la sanitàText Analytics for health 10 per l'API basata sul Web, 1000 per il contenitore.10 for the web-based API, 1000 for the container.
Endpoint di analisiAnalyze endpoint 25 per tutte le operazioni.25 for all operations.

Limiti di velocitàRate limits

Il limite di velocità varia in base al piano tariffario in uso.Your rate limit will vary with your pricing tier. Questi limiti sono identici per entrambe le versioni dell'API.These limits are the same for both versions of the API. Questi limiti di velocità non si applicano al contenitore Analisi del testo per la sanità, che non prevede un limite di velocità impostato.These rate limits don't apply to the Text Analytics for health container, which does not have a set rate limit.

LivelloTier Richieste al secondoRequests per second Richieste al minutoRequests per minute
S/multiservizioS / Multi-service 10001000 10001000
S0/F0S0 / F0 100100 300300
S1S1 200200 300300
S2S2 300300 300300
S3S3 500500 500500
S4S4 10001000 10001000

Le percentuali di richieste vengono misurate per ogni funzionalità di Analisi del testo separatamente.Requests rates are measured for each Text Analytics feature separately. È possibile inviare il numero massimo di richieste previsto per il piano tariffario per ogni funzionalità, contemporaneamente.You can send the maximum number of requests for your pricing tier to each feature, at the same time. Ad esempio, se con il livello S si inviano 1000 richieste contemporaneamente, non sarà possibile inviare un'altra richiesta per 59 secondi.For example, if you're in the S tier and send 1000 requests at once, you wouldn't be able to send another request for 59 seconds.

Vedere ancheSee also