Aller au contenu principal

Trouvez votre prochain outil

Documentation/API/API image : compresser, redimensionner, convertir
API

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.

Guides associés