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.

This article explains the image optimizer engine query API.




Parameter: width    Units: Pixels    Default: auto

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






Parameter: height    Units: Pixels    Default: auto

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





Aspect Ratio Crop

Parameter: aspect_ratio    Default: auto

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






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.






Parameter: sharpen    Units: Boolean    Default: false

Sharpen the output image.





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

Blur the output image.






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 after the crop and the resized measurements apply.

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





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.






Parameter: flip    Units: Boolean    Default: false

Flip the output image vertically.





Parameter: flop    Units: Boolean    Default: false

Flip the output image horizontally.





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

Adjusts the brightness of the output image.






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

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






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.






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

Adjusts the gamma of the output image.






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

Adjusts the contrast of the output image.





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.





Force Image Optimization

Parameter: optimizer    Units: String    Values: image    Default: none

In the event your image is not detected correctly by the Optimizer, such as no file extension or content-type, you can use this parameter to force the optimization.


Table of Contents

Was this article helpful?
149 out of 203 found this helpful