Siteversneller-API

Deze tekst is vertaald met AI. Als je de oorspronkelijke tekst in het Engels wilt bekijken, klik dan hier.

Site Accelerator van Jetpack is een Content Delivery Network (CDN) op WordPress.com, geoptimaliseerd om je site te versnellen door afbeeldingen en statische bestanden sneller te leveren. Deze handleiding legt uit hoe je de API en beschikbare argumenten gebruikt.

Site Accelerator CDN is automatisch ingeschakeld op sites met de WordPress.com Business- en Commerce-abonnementen.

Queryargumenten

Je kunt afbeeldingen die via de Site Accelerator CDN worden geleverd bijsnijden, van formaat veranderen en filteren met de volgende GET-queryparameters.

GET?w=

Stel de breedte (width) van een afbeelding in pixels in:

?w=300

Afbeelding van het bord van het Fox Oakland Theater met een groen verkeerslicht op de voorgrond en een menigte mensen die door de straat loopt.

GET?h=

Stel de hoogte (height) van een afbeelding in pixels in:

?h=200

Close-up van paarse lavendelbloemen met een bij die nectar verzamelt.

GET?crop=x,y,w,h

Snijd een afbeelding bij op basis van percentages: x-offset, y-offset, width, height (x,y,w,h). Percentages worden gebruikt zodat je de bijsnijding niet opnieuw hoeft te berekenen wanneer je de afbeelding op andere manieren transformeert, zoals door de grootte aan te passen.

De volgende afbeelding neemt bijvoorbeeld een rechthoek van 60% bij 60% uit de bronafbeelding, beginnend op 12% offset vanaf links en 25% offset vanaf boven.

?crop=12,25,60,60

Close-up van glazen potjes met verschillende kleurrijke sauzen of jams, weergegeven op een wit tafelkleed, met kleine lepels ernaast.

De volgende afbeelding neemt een vierkant van 788 bij 788, beginnend bij 160 bij 160.

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

Close-up van drie glazen potjes met bolle deksels, elk gevuld met sauzen of jams in verschillende kleuren, geplaatst op een wit tafelkleed.

Je kunt de parametertypen ook combineren, bijvoorbeeld een rechthoek van 1400 pixels bij 60% uit de afbeelding, beginnend bij 160 pixels bij 25%.

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

Een rij kleine glazen potjes met kleurrijke sauzen of condiments, elk met een glazen deksel erop, geplaatst op een wit tafelkleed met zilveren lepels ernaast.

GET?resize=

Pas de grootte van een afbeelding aan en snijd deze bij tot de exacte pixelafmetingen voor width,height. Stel het eerste getal zo dicht mogelijk bij de doelgrootte in en snijd vervolgens de rest bij. In welke richting de grootte wordt aangepast en de afbeelding wordt bijgesneden, hangt af van de beeldverhoudingen van de originele afbeelding en de doelgrootte.

?resize=400,220

Prachtig uitzicht op een kustlandschap met heuvels, een slingerende weg en een heldere blauwe lucht.

?resize=200,400

Een cyperse kat die met zijn voorpoten op een balkonreling rust, met een onscherpe achtergrond van groen.

Dit is handig om een afbeelding van elke grootte op een bepaalde plek te laten passen, terwijl er zo weinig mogelijk van de afbeelding verloren gaat.

GET?fit=

Laat een afbeelding passen binnen een kader met de afmetingen width, height. De beeldverhouding van de afbeelding blijft behouden.

?fit=300,300

Een reflecterende metalen bolsculptuur op een nat oppervlak, waarin de omliggende stad en bomen worden weerspiegeld.

?fit=300,300

Een fles Jameson Distillery Reserve 12 whiskey naast een glas rode wijn op een eettafel.

Bijvoorbeeld: fit=100,100 op een liggende afbeelding met afmetingen 400×300 resulteert in een afbeelding van 100×75, terwijl fit=100,100 op een staande afbeelding met afmetingen 300×400 resulteert in een afbeelding van 75×100.

GET?lb=

Voeg een zwart letterboxing-effect toe aan afbeeldingen door ze te schalen naar width, height, terwijl de beeldverhouding behouden blijft en de rest met zwart wordt gevuld.

Originele afbeelding

Een prachtig uitzicht op een kalme zee met rotsachtige oevers onder een bewolkte lucht, met een verre kustlijn en bergen.

?lb=310,250

Prachtig uitzicht op een rotsachtige kustlijn met golven die tegen de rotsen slaan, onder een bewolkte lucht, met bergen en een kustplaats in de verte.

GET?ulb=

Verwijder het zwarte letterboxing-effect uit afbeeldingen met ulb. Deze functie heeft slechts één argument: true.

Originele afbeelding

Zwart-witafbeelding van twee mannen in een menigte, van wie er één een pet draagt met 'RIP G' erop en de ander toekijkt.

?ulb=true

Zwart-witafbeelding van twee personen in een levendige sfeer, van wie er één een pet draagt met 'RIP' erop en glimlacht, terwijl de ander nadenkend lijkt.

GET?filter=

De parameter filter wordt gebruikt om een van meerdere filters toe te passen. Geldige waarden zijn: negate, grayscale, sepia, edgedetect, emboss, blurgaussian, blurselective, meanremoval.

Originele afbeelding

Een kop thee met een theezakje op een schoteltje, met een stuk gebak en een theepot op de achtergrond.

?filter=negate

Een omgekeerde afbeelding van een kop met een theezakje op een schoteltje, met een blauw gebakje en een theepot.

?filter=grayscale

Een zwart-witafbeelding van een koffiekop met een label van een theezakje, een stuk brood en een theepot op de achtergrond, geplaatst op een houten oppervlak.

?filter=sepia

Een kop koffie met een theezakje op het schoteltje, met een koekje en een theepot op de achtergrond.

?filter=edgedetect

Een kop koffie op een schoteltje met een koekje, met een theepot erbij, met een label op de kop.

?filter=emboss

Kop koffie met een gebakje op een bord, een suikerzakje in de kop en een theepot op de achtergrond, artistiek gefilterd.

?filter=blurgaussian

Een kop thee met een label van een theezakje, met een theepot en een stuk brood op een schoteltje, geplaatst op een houten tafel.

?filter=blurselective

Een kop koffie met een logosticker erop, met een klein bordje met een gebakje, een theepot en een suikerzakje, allemaal geplaatst op een houten tafel.

?filter=meanremoval

Een kop thee met een theezakje dat op de rand rust, met een gebakje op een bord, op een houten tafel.

GET?brightness=

Pas de helderheid van een afbeelding aan. Geldige waarden lopen van -255 tot en met 255, waarbij -255 zwart is en 255 wit. Hoger is helderder. De standaardwaarde is nul.

?brightness=-40

Een vogel in vlucht tegen een grijze lucht.

?brightness=0

Een vogel die vliegt tegen een bewolkte grijze lucht.

?brightness=80

Een witte vogel in vlucht tegen een felwitte achtergrond.

GET?contrast=

Pas het contrast van een afbeelding aan. Geldige waarden lopen van -100 tot en met 100. De standaardwaarde is nul.

?contrast=-50

Een vogel die vliegt tegen een bewolkte lucht.

?contrast=0

?contrast=50

Een vogel in vlucht tegen een witte achtergrond.

GET?colorize=

Voeg kleurtinten toe aan een afbeelding met colorize door een door komma’s gescheiden lijst met rood, groen en blauw (RGB) door te geven. Bijvoorbeeld waarden zoals 255,0,0 (rood), 0,255,0 (groen), 0,0,255 (blauw).

?colorize=100,0,0

?colorize=0,100,0

?colorize=0,0,100

Een vuurtoren op een rotsachtige klif met groen eromheen en een blauwe lucht op de achtergrond.

GET?smooth=

De parameter smooth kan worden gebruikt om de afbeelding gladder te maken.

Originele afbeelding

Close-up van een vintage vliegtuigmotor en propeller met een oranje-wit kleurenschema, met de motoronderdelen en een glimp van het landschap in de reflectie.

?smooth=1

Close-up van een oranje-wit vintage vliegtuig met een propeller, tegen een heldere blauwe lucht.

Volgens de PHP-handleiding past de functie een convolutiematrix met 9 cellen toe, waarbij de middelste pixel wordt gewogen met de waarde van het eerste argument en alle omliggende pixels een gewicht van 1 hebben. Het resultaat wordt genormaliseerd door te delen door het totale gewicht. Simpeler gezegd: een waarde van 0 zorgt voor maximale vervaging, terwijl hogere waarden het vervagingseffect verminderen. Waarden rond 2048 of hoger hebben weinig tot geen zichtbaar effect.

GET?zoom=

Gebruik zoom om afbeeldingen te schalen voor apparaten en browsers met een hoge pixelratio wanneer er is ingezoomd. Niet beschikbaar voor gebruik met crop. Zoom is bedoeld voor gebruik door scripts zoals devicepx.js, die automatisch het zoomniveau instellen. Geldige zoomniveaus zijn 1, 1.5, 2-10.

Originele afbeelding

Een kind dat een stok vasthoudt waar rook vanaf komt, voor een menigte tijdens een viering buiten, met bergen op de achtergrond.

?zoom=2

Een jong meisje in een blauwe jurk houdt een hoge bundel brandende stokken vast terwijl een Ethiopische vlag op de achtergrond wappert. De scène speelt zich af in een landelijk gebied met een groep toeschouwers op de achtergrond.

GET?quality=

Gebruik deze parameter om de uitvoerkwaliteit van de afbeeldingen te beheren. Geldige instellingen liggen tussen de waarden 10 en 100. De mate van compressie hangt af van de afbeelding, of deze lossy of lossless is, en de mogelijkheden van de aanvragende internetbrowser.

Voor lossless afbeeldingen leidt een kwaliteitsinvoer lager dan 100 tot een lossy afbeelding, mits de aangevraagde browser dit afbeeldingstype ondersteunt. Hieronder staat een voorbeeld dat laat zien hoe een niet-transparante PNG-afbeelding (lossless) wordt geconverteerd naar een JPEG (of lossy WebP als de browser dit ondersteunt) wanneer quality is opgegeven.

Als quality niet is opgegeven, probeert photon de oorspronkelijke kwaliteit te behouden.

Originele afbeelding

Close-upafbeelding van twee zwarte mieren die met elkaar interageren op een stuk hout, met een onscherpe groene achtergrond.

?quality=50

Close-up van twee mieren die verwikkeld zijn in een confrontatie op een houten oppervlak, met een onscherpe natuurlijke achtergrond.

Originele png-afbeelding

?quality=60

GET?allow_lossy=

Gebruik deze parameter om te bepalen of de Image CDN een lossy-gecomprimeerde versie van een afbeelding mag leveren. Wanneer allow_lossy=1 is opgegeven, probeert de CDN een lossy-indeling te leveren (bijvoorbeeld JPEG of WebP) als de aanvragende browser dit ondersteunt.

Hieronder staat een voorbeeld dat laat zien hoe een niet-transparante PNG-afbeelding (lossless) kan worden geconverteerd naar een JPEG (of lossy WebP als de browser dit ondersteunt) wanneer allow_lossy=1 in de aanvraag is opgenomen.

Originele png-afbeelding

?allow_lossy=1

GET?strip=

Gebruik de functionaliteit strip om te bepalen hoe metadata wordt behouden. Kleurprofielen worden altijd toegepast en verwijderd, maar andere metadata kunnen behouden blijven. Standaard worden alle gegevens verwijderd, waarbij eventuele bestaande oriëntatiegegevens eerst op de afbeelding worden toegepast. Er zijn 2 geldige instellingen voor deze parameter:

all: verwijdert alle overbodige gegevens (dit is de standaardinstelling).
none: behoudt Exif, IPTC en XMP.

Originele afbeelding

Close-up van gele bloemen met een groene achtergrond.

?strip=none

Close-up van levendige gele bloemen tussen groen bladerdek, van bovenaf genomen.

Laatste update: juni 22, 2026