saturation
The saturation transformation adjusts the intensity and purity of colors in an image. Increase saturation to make colors more vibrant and vivid, or decrease it for a more muted, subtle appearance. Perfect for creating eye-catching graphics, vintage effects, or achieving a more neutral color palette.
Serving Content via CDN
The Media API is a CDN-based service that serves transformed images via GET requests. When you request a transformed image URL, the transformation is applied dynamically on the first request and then cached for subsequent requests.
URL Pattern
https://media.vyso.io/saturation:value=MULTIPLIER/ASSET_ID.jpgExamples
Vibrant Colors (High Saturation)
curl -i GET https://media.vyso.io/saturation:value=1.8/ASSET_ID.jpgEnhanced Saturation
curl -i GET https://media.vyso.io/saturation:value=1.4/ASSET_ID.jpgNormal Saturation
curl -i GET https://media.vyso.io/saturation:value=1.0/ASSET_ID.jpgDesaturated (Muted Colors)
curl -i GET https://media.vyso.io/saturation:value=0.5/ASSET_ID.jpgCompletely Desaturated (Like Grayscale)
curl -i GET https://media.vyso.io/saturation:value=0.0/ASSET_ID.jpgOn the first request, you'll receive a X-Cache: MISS header while the transformation is applied and cached. Subsequent requests will return X-Cache: HIT.
Parameters
valueREQUIREDThe saturation multiplier factor to apply. Accepted values:
- Range: 0.0 to 2.0+
1.0- Original saturation (default, no change)- Values above 1.0 (e.g.,
1.5) - Increase saturation, vibrant colors - Values below 1.0 (e.g.,
0.5) - Decrease saturation, muted colors 0.0- Completely desaturated (grayscale effect)- Decimal values are supported for fine-tuned adjustments
Response
The API returns an image with the specified saturation applied. Higher values intensify colors and make them more vivid, while lower values create a more neutral, muted appearance. The response format depends on the format of the asset stored in the Vyso asset cloud.
Content-Type: Determined by the stored asset format (e.g., image/jpeg, image/png)