Per sviluppatori e utenti API

API per l'ottimizzazione delle immagini per sviluppatoriL'intera procedura tramite una REST API

Costruisci siti per le attività dei tuoi clienti? L'intera procedura tramite una REST API, con file JSON sidecar per il tuo CMS: il testo di ricerca più le note di posizionamento secondo il framework HEART di Google per ogni immagine.

Primo piano del codice di un sito in un editor di testo, con sintassi PHP di Laravel e struttura HTML
Chiave API
Autenticazione
JSON + SSE
Formato di risposta
60 al minuto con Pro, 120 con Agency
Limite di richieste

Quanto costa farlo da soli

  • Integrare la compressione delle immagini in un CMS personalizzato richiede librerie di codec a basso livello
  • Le API di visione IA fatturano ogni chiamata e non includono una pipeline di compressione
  • Integrare strumenti separati per compressione, conversione e metadati è complesso
  • Monitorare il consumo di crediti su più progetti richiede un monitoraggio per chiave
  • Ospitare in proprio l'infrastruttura di elaborazione delle immagini costa più dei crediti API

Cosa torna indietro per ogni immagine

Dal nostro test sul campione, la foto di un cliente: architetto, da 1,9 MB a 380 KB in AVIF (funziona nel piano Free). Il testo alternativo è scritto dall'IA, da Starter in su.
VocePrimaDopo
FileJPG originale · 1,9 MBmodern-luxury-villa-with-swimming-pool-landscape.avif · 380 KB
Testo alternativo(vuoto)“Modern two-story luxury villa featuring large glass windows and a turquoise swimming pool under a blue sky” [Villa di lusso moderna su due piani con ampie vetrate e una piscina turchese sotto un cielo azzurro]
DimensioniUn solo file a dimensione piena150×150 · 300w · 768w · 1024w
MetadatiNessunoFile JSON sidecar: titolo, testo alternativo, didascalia, parole chiave
Sviluppatori e utenti API

Come si adatta al tuo modo di lavorare

Architettura dell'API

La REST API segue un flusso basato su sessioni:

1. Crea una sessione — POST /v1/sessions con le tue immagini.
2. Analizza — POST /v1/analyze per eseguire la visione IA sulle immagini della sessione. Le risposte arrivano in streaming tramite Server-Sent Events.
3. Controlla i metadati — GET sui risultati dell'analisi. Modificali se necessario.
4. Esporta — POST /v1/export con formato, qualità e impostazioni di ridimensionamento.
5. Scarica — GET sui file elaborati.

Ogni passaggio è richiamabile in modo indipendente. Esegui solo l'analisi. Esegui solo l'esportazione. Salta i passaggi che non ti servono.

Autenticazione e crediti

Autenticati con una chiave API nell'intestazione X-API-Key. L'accesso all'API inizia dal piano Pro: Pro ottiene 5 chiavi, Agency 20. Free e Starter non hanno accesso all'API.

Ogni chiamata API che elabora un'immagine scala crediti dal saldo del tuo account. Controlla il saldo con GET /v1/credits/balance. Verifica in anticipo i costi con POST /v1/credits/check prima di avviare un batch.

Esempi di integrazione

Pipeline CI/CD — Aggiungi un passaggio di elaborazione delle immagini alla build. Prima del deploy, invia con POST tutte le nuove immagini all'API. Sostituisci i file sorgente con l'output ottimizzato. Esegui il deploy.

CMS headless — Quando un editor carica un'immagine, il tuo backend la invia con POST a Picture Optimizer, riceve la versione ottimizzata e la salva nello storage degli asset.

Generatore di siti statici — Durante la build, analizza la cartella /images. Invia con POST ogni file all'API. Sostituiscilo con l'output ottimizzato. Costruisci il sito con immagini compresse e con metadati.

Enterprise · by enquiry

We do it for you, with our designers and photography experts.

For large stores, catalogues and blogs. We resize, convert and tune every image, then upload SEO alt text and EXIF to your site. No file is too big.

Domande

Ciò che le persone chiedono prima di iniziare.

L'API usa richieste HTTP standard con risposte JSON. Funziona qualsiasi client HTTP: cURL, fetch, axios, requests. Oggi non esiste un SDK specifico per linguaggio.

Dal blog: Velocità della pagina e Core Web Vitals