Claude API : la taille de requête maximale passe de 32 Mo à 128 Mo

Anthropic a relevé la taille de requête maximale de l’API Claude pour la Messages API et la Token Counting API, de 32 Mo à 128 Mo. Le changement concerne la Claude API exploitée directement par Anthropic et figure dans les Claude Release Notes, dans l’entrée du 28 octobre.

Que change la taille de requête de 128 Mo dans la Claude API ?

Concrètement, il s’agit de la quantité de données qu’on peut faire tenir dans un seul appel POST /v1/messages avant que l’API ne réponde par l’erreur 413 request_too_large. La limite porte sur la requête entière : texte, historique de la conversation, images et PDF envoyés en base64.

D’après la documentation sur la vision, une image peut peser jusqu’à 10 Mo (après encodage en base64), et une requête API peut contenir jusqu’à 600 images (100 pour les modèles dotés d’une fenêtre de contexte de 200 000 tokens). Avec l’ancienne limite, quelques grosses images suffisaient à épuiser les 32 Mo bien avant d’approcher la limite du nombre d’images. Désormais, la marge est quatre fois plus grande.

Même chose pour les PDF. Selon la page sur la prise en charge des PDF, une requête couvre jusqu’à 600 pages (100 quand la fenêtre de contexte de la requête fait moins d’un million de tokens), et les deux limites, pages et taille, s’appliquent à la requête entière. Les longs contrats ou les scans chargés de graphiques, comme ceux que vise Claude for Legal, sont désormais plus faciles à envoyer d’un seul bloc.

Où s’appliquent les nouvelles limites ?

Uniquement sur la Claude API exploitée par Anthropic (l’API dite « first-party »). Le tableau actuel de la présentation de l’API se présente ainsi :

Endpoint	Taille de requête maximale
Messages, Token Counting	128 Mo
Message Batches API	256 Mo
Files API	500 Mo
Sessions, Agents, Environments	32 Mo

Sur les autres plateformes, les limites sont différentes :

1. Amazon Bedrock : 20 Mo.
2. Claude Models on Google Cloud (géré par Google) : 30 Mo.
3. Claude Platform on AWS, Claude Models on Google Cloud (géré par Anthropic) et Microsoft Foundry : Messages et Token Counting toujours limités à 32 Mo.

Un détail amusant tiré de la description des erreurs de l’API : sur la Claude API, c’est Cloudflare qui renvoie l’erreur 413, avant même que la requête n’atteigne les serveurs de l’API.

Fini les contournements avec la Files API ?

Pas forcément. La documentation recommande toujours d’envoyer les gros PDF et les lots d’images via la Files API et de les référencer par file_id. Un fichier peut y peser 500 Mo, et l’organisation entière dispose de 1 To d’espace.

Il reste aussi quelques contraintes que la nouvelle limite ne change pas :

1. Quand une requête contient plus de 20 images, chacune est soumise à une limite de dimensions plus stricte. La documentation conseille de garder le plus grand côté sous 3000 px ou de s’en tenir à 20 blocs d’images et de documents.
2. Les PDF denses peuvent remplir la fenêtre de contexte avant d’atteindre la limite de pages, même avec la Files API.
3. Les agents de Claude Managed Agents (Sessions, Agents, Environments) restent à 32 Mo.

(La taille de la requête n’est pas le coût : chaque image et chaque page de PDF se transforme en tokens, donc mieux vaut regarder ce qu’on consomme vraiment, comme dans mes mesures de la consommation de tokens dans Claude Code.)

À quoi faire attention ?

D’abord, à la plateforme. Si on utilise Claude via Bedrock, Google Cloud ou Foundry, rien n’a changé, et du code qui fonctionne sur la Claude API peut y recevoir une 413.

Ensuite, au token counting. La limite de 128 Mo s’applique aussi à la Token Counting API : on peut donc compter une grosse requête avant de l’envoyer.

Enfin, au manque de détails. L’entrée des Release Notes tient en une phrase et ne dit ni pourquoi la limite augmente maintenant, ni si les limites des plateformes partenaires vont évoluer de la même façon.

FAQ

Quelle est la taille de requête maximale dans la Claude API ?

Sur la Claude API exploitée par Anthropic : 128 Mo pour Messages et Token Counting, 256 Mo pour Message Batches et 500 Mo pour la Files API. Sessions, Agents et Environments sont à 32 Mo.

Que signifie l’erreur 413 request_too_large dans la Claude API ?

Que la requête a dépassé la limite d’octets de l’endpoint concerné. La solution : réduire les images, découper le document, ou envoyer les fichiers via la Files API et les référencer par file_id.

La limite de 128 Mo s’applique-t-elle sur Amazon Bedrock ?

Non. Selon la documentation, Bedrock est limité à 20 Mo, et Claude Platform on AWS à 32 Mo pour Messages et Token Counting.

Combien de pages PDF peut-on envoyer à Claude en une requête ?

Jusqu’à 600 pages, et jusqu’à 100 quand la fenêtre de contexte de la requête fait moins d’un million de tokens. La requête entière doit en plus tenir dans la limite de taille.