API image : compresser, redimensionner, convertir
Redimensionnez, recadrez, faites pivoter, compressez selon une qualité ou une taille cible en octets, et convertissez des images en JPG, PNG, WebP ou AVIF en un seul appel de pipeline.
Réponse courte
Envoyez POST /api/v1/pipeline/ avec un sourceKey et une étape {"operation":"image","pipeline":[…]} listant jusqu’à 8 opérations : resize (maxWidth, maxHeight), crop (x, y, width, height), rotate (degrees), compress (quality de 1 à 100 ou targetBytes) et convert (jpg, png, webp, avif). Pour les images déjà présentes dans Mes documents, utilisez /documents/{documentId}/process/ avec {"operation":"image","pipeline":[…]}.
Compresser pour le web
Un pipeline typique pour des photos produit limite les dimensions et convertit en WebP. Lors de notre test, un PNG de 224 Ko est devenu un WebP de 30 Ko, large de 400 px, en environ 4 secondes.
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" } ] } ] }'Atteindre une taille de fichier cible
Les portails de dépôt exigent souvent « moins de 200 Ko ». Utilisez compress avec targetBytes plutôt que quality ; le worker recherche la qualité la plus élevée qui respecte la cible. Les cibles doivent se situer entre le minimum et le maximum autorisés par l’API (jusqu’à 20 Mo).
{ "operation": "image", "pipeline": [ { "operation": "resize", "maxWidth": 1200 }, { "operation": "compress", "targetBytes": 204800, "format": "jpg" } ] }Enchaîner les étapes d’image avec PDF et OCR
Un pipeline peut se poursuivre après l’étape d’image : ajoutez {"operation":"convert","format":"pdf"} pour placer le résultat dans un PDF, ou {"operation":"ocr","format":"pdf"} pour le rendre interrogeable. Lorsque l’étape suivante l’exige, l’étape d’image produit automatiquement du PNG.
Questions fréquentes
La compression supprime-t-elle les métadonnées ?
Les images réencodées ne conservent pas les données EXIF, comme la position GPS, ce qui est généralement souhaitable pour des images publiques.
Quel format choisir ?
WebP pour les sites web, JPG lorsque la compatibilité prime, PNG pour les captures d’écran et les dessins au trait, AVIF pour obtenir les fichiers les plus légers si votre public utilise des navigateurs récents.