Saltar al contenido principal

Encuentra tu próxima herramienta

Documentación/API/API de imágenes: comprimir, escalar y convertir
API

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.

Guías relacionadas