Claude API: la dimensione massima della richiesta sale da 32 MB a 128 MB

Anthropic ha portato la dimensione massima della richiesta in Claude API per la Messages API e la Token Counting API da 32 MB a 128 MB. La modifica riguarda la Claude API gestita direttamente da Anthropic ed è comparsa nelle Claude Release Notes, nella voce del 28 ottobre.

Cosa cambia con la dimensione richiesta di 128 MB in Claude API?

In pratica si parla di quanti dati entrano in una singola chiamata POST /v1/messages prima che l’API risponda con l’errore 413 request_too_large. Al limite conta l’intera richiesta: testo, cronologia della conversazione, immagini e PDF inviati in base64.

Secondo la documentazione sulla visione, una singola immagine può arrivare a 10 MB (dopo la codifica base64), e in una richiesta API ci stanno fino a 600 immagini (100 per i modelli con una finestra di contesto da 200.000 token). Con il vecchio limite bastavano poche immagini grandi per esaurire i 32 MB, ben prima di avvicinarsi al limite sul numero di immagini. Ora il margine è quattro volte più ampio.

Lo stesso vale per i PDF. Secondo la pagina sul supporto PDF, una richiesta comprende fino a 600 pagine (100 quando la finestra di contesto della richiesta è inferiore a 1 milione di token), ed entrambi i limiti, pagine e dimensione, si applicano all’intera richiesta. Contratti lunghi o scansioni piene di grafica, come quelli a cui punta Claude for Legal, ora si inviano più facilmente in un unico blocco.

Dove valgono i nuovi limiti?

Solo sulla Claude API gestita da Anthropic (la cosiddetta API «first-party»). La tabella attuale della panoramica dell’API è questa:

Endpoint	Dimensione massima della richiesta
Messages, Token Counting	128 MB
Message Batches API	256 MB
Files API	500 MB
Sessions, Agents, Environments	32 MB

Sulle altre piattaforme i limiti sono diversi:

1. Amazon Bedrock: 20 MB.
2. Claude Models on Google Cloud (gestito da Google): 30 MB.
3. Claude Platform on AWS, Claude Models on Google Cloud (gestito da Anthropic) e Microsoft Foundry: Messages e Token Counting restano a 32 MB.

Una curiosità dalla descrizione degli errori dell’API: sulla Claude API l’errore 413 lo restituisce Cloudflare, prima ancora che la richiesta arrivi ai server dell’API.

È la fine dei trucchi con la Files API?

Non per forza. La documentazione continua a consigliare di inviare PDF grandi e molte immagini tramite la Files API e di richiamarli con file_id. Lì un singolo file può arrivare a 500 MB, e l’intera organizzazione ha 1 TB di spazio.

Ci sono poi alcuni vincoli che il limite più alto non tocca:

1. Quando in una richiesta ci sono più di 20 immagini, ognuna è soggetta a un limite di dimensioni più severo. La documentazione suggerisce di tenere il lato lungo sotto i 3000 px oppure di restare a 20 blocchi tra immagini e documenti.
2. I PDF densi possono riempire la finestra di contesto prima di raggiungere il limite di pagine, anche con la Files API.
3. Gli agenti di Claude Managed Agents (Sessions, Agents, Environments) restano a 32 MB.

(La dimensione della richiesta non coincide con il costo: ogni immagine e ogni pagina PDF diventa token, quindi conviene controllare quanto consumiamo davvero, come nelle mie misurazioni del consumo di token in Claude Code.)

A cosa fare attenzione?

Primo, alla piattaforma. Se usiamo Claude tramite Bedrock, Google Cloud o Foundry, non è cambiato nulla, e il codice che funziona sulla Claude API lì può ricevere un 413.

Secondo, al token counting. Il limite di 128 MB vale anche per la Token Counting API, quindi possiamo contare una richiesta grande prima di inviarla.

Terzo, alla mancanza di dettagli. La voce nelle Release Notes è una sola frase e non dice perché il limite sia salito proprio ora, né se cambieranno allo stesso modo i limiti sulle piattaforme partner.

FAQ

Qual è la dimensione massima della richiesta in Claude API?

Sulla Claude API gestita da Anthropic: 128 MB per Messages e Token Counting, 256 MB per Message Batches e 500 MB per la Files API. Sessions, Agents ed Environments hanno 32 MB.

Cosa significa l’errore 413 request_too_large in Claude API?

Che la richiesta ha superato il limite di byte per quell’endpoint. La soluzione è ridurre le immagini, dividere il documento oppure caricare i file tramite la Files API e richiamarli con file_id.

Il limite di 128 MB vale su Amazon Bedrock?

No. Secondo la documentazione, Bedrock ha un limite di 20 MB, e Claude Platform on AWS di 32 MB per Messages e Token Counting.

Quante pagine PDF si possono inviare a Claude in una richiesta?

Fino a 600 pagine, oppure fino a 100 quando la finestra di contesto della richiesta è inferiore a 1 milione di token. L’intera richiesta deve comunque rientrare nel limite di dimensione.