API de imágenes: comprimir, escalar y convertir
Redimensiona, recorta, gira, comprime a una calidad o a un tamaño objetivo en bytes y convierte imágenes a JPG, PNG, WebP o AVIF en una sola llamada de pipeline.
Respuesta breve
Envía POST /api/v1/pipeline/ con un sourceKey y un paso {"operation":"image","pipeline":[…]} que enumere hasta 8 operaciones: resize (maxWidth, maxHeight), crop (x, y, width, height), rotate (degrees), compress (quality 1–100 o targetBytes) y convert (jpg, png, webp, avif). Para imágenes que ya están en Mis documentos, usa /documents/{documentId}/process/ con {"operation":"image","pipeline":[…]}.
Comprime para la web
Un pipeline típico para fotos de producto limita el tamaño y convierte a WebP. En nuestra prueba, un PNG de 224 KB se convirtió en un WebP de 30 KB y 400 px de ancho en unos 4 segundos.
curl -X POST 'https://maxscanner.app/api/v1/pipeline/' \
-H "Authorization: Bearer $MAXSCANNER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{ "sourceKey": "users/<id>/media/inbox/…-photo.png", "steps": [ { "operation": "image", "pipeline": [ { "operation": "resize", "maxWidth": 1600 }, { "operation": "compress", "quality": 75, "format": "webp" } ] } ] }'Alcanza un tamaño de archivo objetivo
Los portales de subida a menudo exigen "menos de 200 KB". Usa compress con targetBytes en lugar de quality; el procesador busca la calidad más alta que cabe. Los objetivos deben estar entre el mínimo y el máximo que permite la API (hasta 20 MB).
{ "operation": "image", "pipeline": [ { "operation": "resize", "maxWidth": 1200 }, { "operation": "compress", "targetBytes": 204800, "format": "jpg" } ] }Encadena pasos de imagen con PDF y OCR
Los pipelines pueden continuar después del paso de imagen: añade {"operation":"convert","format":"pdf"} para envolver el resultado en un PDF, o {"operation":"ocr","format":"pdf"} para que admita búsquedas. Cuando el paso siguiente lo necesita, el paso de imagen genera PNG automáticamente.
Preguntas frecuentes
¿La compresión elimina los metadatos?
Las imágenes recodificadas no conservan datos EXIF como la ubicación GPS, que suele ser lo que quieres para imágenes públicas.
¿Qué formato debo elegir?
WebP para sitios web, JPG cuando lo que más importa es la compatibilidad, PNG para capturas de pantalla y dibujos de líneas, y AVIF para obtener los archivos más pequeños cuando tu público usa navegadores modernos.