Vai al contenuto principale

Trova il prossimo strumento

Documentazione/API/API Immagini: comprimi, ridimensiona e converti
API

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.

Guide correlate