Saturation

​

How to use

The saturation transformation allows you to adjust the intensity of colors in an image.

Pass the following query param to the API endpoint:

saturation=amount

Where:

• amount is the percentage to increase or decrease the image saturation.

For example: saturation=50 or saturation=-30

​

Parameter

amount: The percentage to adjust the saturation. This parameter accepts values from -100 to 100:

• Positive values increase saturation (more vibrant colors)
• Negative values decrease saturation (more muted colors)
• 0 leaves the saturation unchanged (default)
• -100 results in a grayscale image
• 100 produces a highly saturated image

​

Effect of Saturation Adjustment

• Increasing saturation makes colors more vivid and intense.
• Decreasing saturation makes colors more muted and gray.
• Extreme adjustments can lead to unnatural-looking images or loss of detail in highly saturated areas.

This transformation can be used to enhance the vibrancy of images, create mood effects, or correct oversaturated or undersaturated photos.

​

Original Image

​

Image with increased saturation

​

Image with decreased saturation

​

Best Practices

• Use moderate saturation adjustments for natural-looking results.
• Increase saturation slightly to make images pop, especially for marketing or promotional materials.
• Decrease saturation to create a more subtle or vintage look.
• Be cautious with high saturation values as they can cause color clipping and loss of detail.
• Consider the context and intended use of the image when adjusting saturation.
• Combine with other adjustments like contrast or brightness for more refined image enhancements.