API dell’Acceleratore del sito

Questo testo è stato tradotto utilizzando l’IA. Se desideri visualizzare il testo originale in inglese, fai clic qui.

Site Accelerator di Jetpack è una rete di distribuzione dei contenuti (CDN) su WordPress.com, ottimizzata per velocizzare il tuo sito fornendo immagini e file statici più rapidamente. Questa guida spiega come utilizzare la sua API e gli argomenti disponibili.

La CDN di Site Accelerator è abilitata automaticamente sui siti con i piani WordPress.com Business e Commerce.

Argomenti di query

Puoi ritagliare, ridimensionare e filtrare le immagini servite dalla CDN di Site Accelerator utilizzando i seguenti parametri di query GET.

GET?w=

Imposta la larghezza di un’immagine in pixel:

?w=300

Immagine dell'insegna del Fox Oakland Theater con un semaforo verde in primo piano e una folla di persone che cammina lungo la strada.

GET?h=

Imposta l’altezza di un’immagine in pixel:

?h=200

Primo piano di fiori di lavanda viola con un'ape che raccoglie il nettare.

GET?crop=x,y,w,h

Ritaglia un’immagine in base a percentuali di offset x, offset y, larghezza (w), altezza (h) (x,y,w,h). Le percentuali vengono utilizzate in modo da non dover ricalcolare il ritaglio quando si trasforma l’immagine in altri modi, come il ridimensionamento.

Ad esempio, l’immagine seguente prende un rettangolo del 60% per 60% dall’immagine sorgente partendo da un offset del 12% da sinistra e del 25% dall’alto.

?crop=12,25,60,60

Primo piano di contenitori in vetro con varie salse o marmellate colorate, esposti su una tovaglia bianca, con piccoli cucchiai accanto.

L’immagine successiva prende un quadrato di 788 per 788 pixel partendo da 160 per 160.

?crop=160px,160px,788px,788px

Primo piano di tre contenitori in vetro con coperchi a cupola, ciascuno contenente salse o marmellate di colori diversi, posizionati su una tovaglia bianca.

È anche possibile combinare i tipi di parametri, ad esempio un rettangolo di 1400 pixel per il 60% dell’immagine partendo da 160 pixel per il 25%.

?crop=160px,25,1400px,60

Una fila di piccoli barattoli in vetro contenenti salse o condimenti colorati, ciascuno con un coperchio in vetro, posizionati su una tovaglia bianca con cucchiai d'argento accanto.

GET?resize=

Ridimensiona e ritaglia un’immagine alle dimensioni esatte in pixel di larghezza (w) e altezza (h). Imposta il primo numero il più vicino possibile alla dimensione desiderata e poi ritaglia il resto. La direzione in cui viene ridimensionata e ritagliata dipende dai rapporti d’aspetto dell’immagine originale e della dimensione di destinazione.

?resize=400,220

Vista panoramica di un paesaggio costiero con colline, una strada tortuosa e un cielo azzurro limpido.

?resize=200,400

Un gatto soriano che appoggia le zampe anteriori sulla ringhiera di un balcone, con uno sfondo sfocato di vegetazione.

Questo è utile per prendere un’immagine di qualsiasi dimensione e adattarla a una posizione specifica perdendo il meno possibile dell’immagine.

GET?fit=

Adatta un’immagine a un riquadro contenitore con dimensioni di larghezza (w) e altezza (h). Il rapporto d’aspetto dell’immagine viene mantenuto.

?fit=300,300

Una scultura a sfera metallica riflettente su una superficie bagnata, che cattura il paesaggio urbano circostante e gli alberi.

?fit=300,300

Una bottiglia di whiskey Jameson Distillery Reserve 12 esposta accanto a un bicchiere di vino rosso su un tavolo da pranzo.

Ad esempio, fit=100,100 su un’immagine orizzontale con dimensioni 400×300 produrrà un’immagine di 100×75, mentre fit=100,100 su un’immagine verticale con dimensioni 300×400 produrrà un’immagine di 75×100.

GET?lb=

Aggiunge un effetto letterbox nero alle immagini, ridimensionandole a larghezza (w) e altezza (h) mantenendo il rapporto d’aspetto e riempiendo il resto con il nero.

Immagine originale

Vista panoramica di un mare calmo con coste rocciose sotto un cielo nuvoloso, che mostra una costa lontana con montagne.

?lb=310,250

Vista panoramica di una costa rocciosa con onde che si infrangono sugli scogli, sotto un cielo nuvoloso, con montagne lontane e una cittadina costiera sullo sfondo.

GET?ulb=

Rimuove l’effetto letterbox nero dalle immagini con ulb. Questa funzione accetta un solo argomento, true.

Immagine originale

Immagine in bianco e nero di due uomini in mezzo alla folla, uno con un berretto con la scritta 'RIP G' e l'altro che osserva.

?ulb=true

Immagine in bianco e nero di due persone in un'atmosfera vivace, una con un berretto con la scritta 'RIP' che sorride, mentre l'altra appare pensierosa.

GET?filter=

Il parametro filter viene utilizzato per applicare uno tra diversi filtri. I valori validi sono: negate, grayscale, sepia, edgedetect, emboss, blurgaussian, blurselective, meanremoval.

Immagine originale

Una tazza di tè con una bustina su un piattino, accompagnata da un pezzo di pasticceria e una teiera sullo sfondo.

?filter=negate

Un'immagine invertita di una tazza con una bustina di tè su un piattino, accompagnata da un pasticcino blu e una teiera.

?filter=grayscale

Un'immagine in bianco e nero di una tazza di caffè con l'etichetta di una bustina di tè, un pezzo di pane e una teiera sullo sfondo, posati su una superficie di legno.

?filter=sepia

Una tazza di caffè con una bustina di tè sul piattino, accompagnata da un biscotto e una teiera sullo sfondo.

?filter=edgedetect

Una tazza di caffè su un piattino con un biscotto, accompagnata da una teiera, con un'etichetta sulla tazza.

?filter=emboss

Tazza di caffè con un pasticcino su un piatto, una bustina di zucchero nella tazza e una teiera sullo sfondo, con filtro artistico applicato.

?filter=blurgaussian

Una tazza di tè con l'etichetta della bustina, accompagnata da una teiera e un pezzo di pane su un piattino, posati su un tavolo di legno.

?filter=blurselective

?filter=meanremoval

Una tazza di tè con una bustina appoggiata sul bordo, accompagnata da un pasticcino su un piatto, posati su un tavolo di legno.

GET?brightness=

Regola la luminosità di un’immagine. I valori validi vanno da -255 a 255, dove -255 corrisponde al nero e 255 al bianco. Valori più alti indicano maggiore luminosità. Il valore predefinito è zero.

?brightness=-40

Un uccello in volo contro un cielo grigio.

?brightness=0

Un uccello in volo contro un cielo grigio nuvoloso.

?brightness=80

Un uccello bianco in volo contro uno sfondo bianco luminoso.

GET?contrast=

Regola il contrasto di un’immagine. I valori validi vanno da -100 a 100. Il valore predefinito è zero.

?contrast=-50

Un uccello in volo contro un cielo nuvoloso.

?contrast=0

?contrast=50

Un uccello in volo contro uno sfondo bianco.

GET?colorize=

Aggiungi tonalità di colore a un’immagine con colorize passando un elenco separato da virgole di valori rosso, verde e blu (RGB). Ad esempio, valori come 255,0,0 (rosso), 0,255,0 (verde), 0,0,255 (blu).

?colorize=100,0,0

?colorize=0,100,0

?colorize=0,0,100

Un faro su una scogliera rocciosa circondato da vegetazione, con un cielo azzurro sullo sfondo.

GET?smooth=

Il parametro smooth può essere utilizzato per applicare un effetto di levigatura all’immagine.

Immagine originale

Vista ravvicinata del motore e dell'elica di un aereo d'epoca con combinazione di colori arancione e bianco, che mostra i componenti del motore e un riflesso del paesaggio.

?smooth=1

Vista ravvicinata di un aereo d'epoca arancione e bianco con elica, sullo sfondo di un cielo azzurro limpido.

Secondo il manuale PHP, la funzione applica una matrice di convoluzione 9 celle in cui il pixel centrale è ponderato con il valore del primo argomento, mentre tutti i pixel circostanti hanno un peso pari a 1. Il risultato viene normalizzato dividendo per il peso totale. In termini più semplici, un valore pari a 0 produce la massima levigatura, mentre valori più alti riducono l’effetto di levigatura. Valori intorno a 2048 o superiori non hanno un impatto visibile significativo.

GET?zoom=

Usa zoom per ridimensionare le immagini per dispositivi e browser ad alto rapporto di pixel quando si effettua lo zoom. Non disponibile in combinazione con crop. Zoom è pensato per essere utilizzato da script come devicepx.js che impostano automaticamente il livello di zoom. I livelli di zoom validi sono 1, 1.5, 2-10.

Immagine originale

Un bambino che tiene un bastone con del fumo che sale, davanti a una folla durante una celebrazione all'aperto, con montagne sullo sfondo.

?zoom=2

Una giovane ragazza vestita con un abito blu tiene un alto fascio di bastoncini accesi mentre una bandiera etiope sventola sullo sfondo. La scena si svolge in un'area rurale con un gruppo di spettatori sullo sfondo.

GET?quality=

Usa questo parametro per gestire la qualità di output delle immagini. I valori validi sono compresi tra 10 e 100. Il grado di compressione dipende dall’immagine, dalla sua natura lossy o lossless e dalle capacità del browser web richiedente.

Per le immagini lossless, fornire un valore di qualità inferiore a 100 produrrà un’immagine lossy, a condizione che il browser richiesto supporti questo tipo di immagine. Di seguito è riportato un esempio che mostra la conversione di un’immagine PNG non trasparente (lossless) in JPEG (o WebP lossy se il browser lo supporta) quando viene specificata la qualità.

Se la qualità non viene specificata, photon cercherà di preservare la qualità originale.

Immagine originale

Immagine ravvicinata di due formiche nere che interagiscono su un pezzo di legno con uno sfondo verde sfocato.

?quality=50

Primo piano di due formiche impegnate in un confronto su una superficie di legno, con uno sfondo naturale sfocato.

Immagine png originale

?quality=60

GET?allow_lossy=

Usa questo parametro per controllare se la rete di distribuzione dei contenuti (CDN) per le immagini può servire una versione compressa in formato lossy di un’immagine. Quando viene specificato allow_lossy=1, il CDN tenterà di fornire un formato lossy (ad esempio, JPEG o WebP) se il browser richiedente lo supporta.

Di seguito è riportato un esempio che mostra come un’immagine PNG non trasparente (lossless) può essere convertita in JPEG (o WebP lossy se il browser lo supporta) quando allow_lossy=1 è incluso nella richiesta.

Immagine png originale

?allow_lossy=1

GET?strip=

Usa la funzionalità strip per controllare come vengono preservati i metadati. I profili colore vengono sempre applicati e rimossi, ma altri metadati possono essere mantenuti. Per impostazione predefinita tutti i dati vengono rimossi, con eventuali dati di orientamento esistenti applicati prima all’immagine. Ci sono 2 impostazioni valide per questo parametro:

all: rimuove tutti i dati superflui (questa è l’impostazione predefinita).
none: preserva Exif, IPTC e XMP.

Immagine originale

Primo piano di fiori gialli con sfondo verde.

?strip=none

Primo piano di vivaci fiori gialli tra il fogliame verde, fotografati dall'alto.

Ultimo aggiornamento: giugno 20, 2026