Skip to main content

​
Límites

​
Dos límites distintos: raw vs storage URL

El upload crudo (body de /convert/raw) tiene un límite propio y mucho más bajo (12 MB) que el tope de procesamiento (500 MB). El raw viaja entero por la red antes de empezar a convertir, así que un body enorme gasta segundos solo en transferencia. Por eso:
  • PDF pequeño → /convert/raw directo.
  • PDF grande → súbelo a tu storage y usa /convert/from-url o /convert/accelerated, que no aplican el límite de raw (siguen FETCH_MAX_BYTES, 500 MB).
Detalle y tabla de tamaños en Raw vs storage URL.

​
Qué pasa al superarlos

  • Upload crudo por encima de RAW_UPLOAD_MAX_BYTES → 413 con un cuerpo JSON útil (error, max_raw_upload_mb, why, recommendation, recommended_endpoint) que te dice cómo hacerlo bien. El error nunca filtra la URL firmada ni rutas internas.
  • Documento o descarga por encima de MAX_INPUT_BYTES/FETCH_MAX_BYTES → 413.
  • PDF con más páginas del límite → 413.
  • ZIP con demasiadas entradas o miembro demasiado grande → 413.
El límite de raw se mide sobre los bytes descomprimidos: un cuerpo gzip/zstd que descomprime por encima del límite también se rechaza.
Puedes subir el límite de raw con RAW_UPLOAD_MAX_BYTES, o desactivarlo del todo con ALLOW_LARGE_RAW_UPLOAD=true (vuelve a MAX_INPUT_BYTES). En general no merece la pena: para archivos grandes, from-url es más rápido.

​
Recomendaciones

  • Para documentos muy grandes, sube a tu storage y usa /convert/from-url: evita reenviar bytes.
  • Comprime la subida con gzip o zstd en /convert/raw.
  • Divide documentos enormes en partes lógicas si solo necesitas secciones.
El valor real para un agente está en responder rápido con Markdown útil, no en aceptar el archivo más grande posible.