BunnyCDN Support Hub

Guides, troubleshooting and support requests to help you get started with BunnyCDN.

Bunny Optimizer Engine Documentation

Bunny Optimizer is a real-time on the fly image manipulation and optimization service that automatically optimizes your images for faster image delivery, bandwidth savings and enables smart dynamic image manipulation using a simple query API.

The system is currently in private Beta testing. If you're interested in participating, please let us know.

This article explains the image optimizer engine query API.

 


 

Width

Parameter: width    Units: Pixels    Default: auto

Resize the output image to the given width maintaining the current aspect ratio.


?width=300

?width=200

?width=150

 

Height

Parameter: height    Units: Pixels    Default: auto

Resize the output image to the given height maintaining the current aspect ratio.


?height=150

?height=125

?height=75

 

Aspect Ratio Crop

Parameter: aspect_ratio    Default: auto

Automatically crop the output image into the given aspect ratio with a central gravity.


?aspect_ratio=1:1

?aspect_ratio=16:9

?aspect_ratio=2:4

 

Quality

Parameter: quality    Units: Percent    Range: 0-100    Default: 85

Optimize the output image to the given compression level, 0 being the lowest and 100 being the highest. Lowering the quality will reduce file size, but might start visibly reducing image quality with values below 70.


?quality=100

?quality=40

?quality=5

 

Sharpen

Parameter: sharpen    Units: Boolean    Default: false

Sharpen the output image.


?sharpen=false

?sharpen=true
 

 

Blur

Parameter: blur    Units: Number    Range: 0-100    Default: 0

Blur the output image.


?blur=0

?blur=25

?blur=80

 

Crop

Parameter: crop    Units: Pixels    Format 1: width,height    Format 2: width,height,x,y

Crop the output image to the given width and height. Two formats are accepted. Format 1 one only includes the width and height of the crop. Format 2 also includes the X and Y position where the crop should start. Image resizing with the width and height parameters is processed before the crop and the resized measurements apply.

If only width and height are given, the Crop Gravity parameter will be used.


?crop=3500,3500

?crop=3500,3500,250,300

?crop=300,300

 

Crop Gravity

Parameter: crop_gravity    Default: center
Values: center,forget,east,north,south,west,northeast,northwest,southeast,southwest

Set the gravity of the crop operation. This is used with the Format 1 cropping only and snaps the crop to the selected position.


?crop_gravity=center

?crop_gravity=west

?crop_gravity=east

 

Flip

Parameter: flip    Units: Boolean    Default: false

Flip the output image vertically.


?flip=false

?flip=true
 

 

Flop

Parameter: flop    Units: Boolean    Default: false

Flip the output image horizontally.


?flop=false

?flop=true
 

 

Brightness

Parameter: brightness    Units: Number    Range: -100-100    Default: 0

Adjusts the brightness of the output image.


?brightness=0

?brightness=15

?brightness=-15

 

Saturation

Parameter: saturation    Units: Number    Range: -100-100    Default: 0

Adjusts the saturation of the output image. Use -100 for grayscale.


?saturation=0

?saturation=50

?saturation=-60

 

Hue

Parameter: hue    Units: Number    Range: 0-100    Default: 0

Adjusts the hue of the output image by rotating the color wheel. The default value of 0 is the base color and increasing the value modulates to the next color for each 33 change.


?hue=0

?hue=33

?hue=66

 

Gamma

Parameter: gamma    Units: Number    Range: -100-100    Default: 0

Adjusts the gamma of the output image.


?gamma=0

?gamma=-25

?gamma=25

 

Contrast

Parameter: contrast    Units: Number    Range: 0-100    Default: 0

Adjusts the contrast of the output image.


?contrast=0

?contrast=20

?contrast=-20

 

Automatic Optimization

Parameter: auto_optimize    Units: String    Values: low,medium,high    Default: none

Automatically enhance the output image with multiple levels of optimizations. With high, sharpening is also applied automatically.


?auto_optimize=low

?auto_optimize=medium

?auto_optimize=high

 

0 Comments

Please sign in to leave a comment.