Límite de tamaño de solicitud de Claude API: de 32 MB a 128 MB
El límite de tamaño de solicitud de Claude API sube a 128 MB, cuatro veces más que antes. Más PDF e imágenes en una llamada. Veamos dónde aplican los nuevos límites.
Este artículo en otros idiomas:العربيةDeutschEnglishFrançaisItaliano日本語Polski简体中文
En este artículo
Anthropic ha subido el límite de tamaño de solicitud de Claude API para la Messages API y la Token Counting API de 32 MB a 128 MB. El cambio afecta a la Claude API que opera directamente Anthropic y aparece en las Claude Release Notes, en la entrada del 28 de octubre.
¿Qué cambia el límite de tamaño de solicitud de 128 MB?
En la práctica, se trata de cuántos datos caben en una sola llamada POST /v1/messages antes de que la API responda con el error 413 request_too_large. Al límite cuenta la solicitud completa: texto, historial de la conversación, e imágenes y PDF enviados en base64.
Según la documentación de visión, una sola imagen puede pesar hasta 10 MB (ya codificada en base64), y en una solicitud a la API caben hasta 600 imágenes (100 en modelos con una ventana de contexto de 200.000 tokens). Con el límite anterior, unas pocas imágenes grandes podían agotar los 32 MB mucho antes de acercarse al límite de número de imágenes. Ahora el margen es cuatro veces mayor.
Lo mismo pasa con los PDF. Según la página sobre soporte de PDF, una solicitud admite hasta 600 páginas (100 cuando la ventana de contexto de la solicitud es de menos de 1 millón de tokens), y ambos límites, de páginas y de tamaño, se aplican a la solicitud completa. Los contratos largos o los escaneos con gráficos, como los que tiene en el punto de mira Claude for Legal, ahora son más fáciles de enviar de una sola vez.
¿Dónde se aplican los nuevos límites?
Solo en la Claude API que opera Anthropic (la llamada API «first-party»). La tabla actual del resumen de la API queda así:
| Endpoint | Tamaño máximo de solicitud |
|---|---|
| Messages, Token Counting | 128 MB |
| Message Batches API | 256 MB |
| Files API | 500 MB |
| Sessions, Agents, Environments | 32 MB |
En las demás plataformas los límites son otros:
- Amazon Bedrock: 20 MB.
- Claude Models on Google Cloud (gestionado por Google): 30 MB.
- Claude Platform on AWS, Claude Models on Google Cloud (gestionado por Anthropic) y Microsoft Foundry: Messages y Token Counting siguen en 32 MB.
Un detalle curioso de la descripción de errores de la API: en la Claude API, el error 413 lo devuelve Cloudflare antes de que la solicitud llegue siquiera a los servidores de la API.
¿Se acabaron los apaños con la Files API?
No necesariamente. La documentación sigue recomendando enviar los PDF grandes y las imágenes en cantidad a través de la Files API y referenciarlos con file_id. Ahí un solo archivo puede pesar 500 MB, y toda la organización dispone de 1 TB de espacio.
También hay algunas restricciones que el límite más alto no cambia:
- Cuando una solicitud lleva más de 20 imágenes, cada una está sujeta a un límite de dimensiones más estricto. La documentación aconseja que el lado más largo no supere los 3000 px o quedarse en 20 bloques de imágenes y documentos.
- Los PDF densos pueden llenar la ventana de contexto antes de llegar al límite de páginas, incluso con la Files API.
- Los agentes de Claude Managed Agents (Sessions, Agents, Environments) se quedan en 32 MB.
(El tamaño de la solicitud no es lo mismo que el coste: cada imagen y cada página de PDF se convierte en tokens, así que conviene echar un ojo a cuánto consumimos de verdad, como en mis mediciones del consumo de tokens en Claude Code.)
¿En qué fijarse?
Primero, en la plataforma. Si usamos Claude a través de Bedrock, Google Cloud o Foundry, no ha cambiado nada, y el código que funciona en la Claude API puede recibir allí un 413.
Segundo, en el token counting. El límite de 128 MB también se aplica a la Token Counting API, así que podemos contar una solicitud grande antes de enviarla.
Tercero, en la falta de detalles. La entrada de las Release Notes es una sola frase y no explica por qué el límite ha subido justo ahora ni si cambiarán de forma parecida los límites en las plataformas de partners.
Preguntas frecuentes
¿Cuál es el tamaño máximo de solicitud en la Claude API?
En la Claude API que opera Anthropic: 128 MB para Messages y Token Counting, 256 MB para Message Batches y 500 MB para la Files API. Sessions, Agents y Environments tienen 32 MB.
¿Qué significa el error 413 request_too_large en la Claude API?
Que la solicitud ha superado el límite de bytes de ese endpoint. La solución es reducir las imágenes, dividir el documento o subir los archivos a través de la Files API y referenciarlos con file_id.
¿El límite de 128 MB funciona en Amazon Bedrock?
No. Según la documentación, Bedrock tiene un límite de 20 MB, y Claude Platform on AWS, de 32 MB para Messages y Token Counting.
¿Cuántas páginas de PDF se pueden enviar a Claude en una solicitud?
Hasta 600 páginas, o hasta 100 cuando la ventana de contexto de la solicitud es de menos de 1 millón de tokens. Además, la solicitud completa tiene que caber en el límite de tamaño.