API Immagini: comprimi, ridimensiona e converti
Ridimensiona, ritaglia, ruota, comprimi in base a una qualità o a una dimensione in byte e converti immagini in JPG, PNG, WebP o AVIF con una sola chiamata pipeline.
Risposta breve
Invia POST /api/v1/pipeline/ con un sourceKey e un passaggio {"operation":"image","pipeline":[…]} che elenca fino a 8 operazioni: resize (maxWidth, maxHeight), crop (x, y, width, height), rotate (degrees), compress (quality 1–100 o targetBytes) e convert (jpg, png, webp, avif). Per le immagini già presenti in I miei documenti usa /documents/{documentId}/process/ con {"operation":"image","pipeline":[…]}.
Comprimere per il web
Una tipica pipeline per foto di prodotto limita le dimensioni e converte in WebP. Nel nostro test un PNG da 224 KB è diventato un WebP da 30 KB, largo 400 px, in circa 4 secondi.
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" } ] } ] }'Raggiungere una dimensione di file prestabilita
I portali di caricamento chiedono spesso file "sotto i 200 KB". Usa compress con targetBytes invece di quality: il worker cerca la qualità più alta che rientra nel limite. I valori obiettivo devono essere compresi tra il minimo e il massimo consentiti dall'API (fino a 20 MB).
{ "operation": "image", "pipeline": [ { "operation": "resize", "maxWidth": 1200 }, { "operation": "compress", "targetBytes": 204800, "format": "jpg" } ] }Concatenare passaggi immagine con PDF e OCR
Le pipeline possono proseguire dopo il passaggio immagine: aggiungi {"operation":"convert","format":"pdf"} per inserire il risultato in un PDF, oppure {"operation":"ocr","format":"pdf"} per renderlo ricercabile. Quando il passaggio successivo lo richiede, il passaggio immagine produce automaticamente un PNG.
Domande frequenti
La compressione rimuove i metadati?
Le immagini ricodificate non conservano i dati EXIF come la posizione GPS, che di solito è proprio ciò che si vuole per le immagini pubbliche.
Quale formato scegliere?
WebP per i siti web, JPG quando la compatibilità conta più di tutto, PNG per screenshot e disegni al tratto, AVIF per ottenere i file più piccoli quando il tuo pubblico usa browser moderni.