hue

The hue transformation rotates the color spectrum of an image, shifting all hues by a specified number of degrees. Perfect for creating color variations, artistic effects, or adjusting color temperature. Rotate through the full 360-degree color wheel.

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/hue:value=DEGREES/ASSET_ID.jpg

Examples

Shift Hue by 30 Degrees

curl -i GET https://media.vyso.io/hue:value=30/ASSET_ID.jpg

Shift Hue by 90 Degrees (Significant Color Change)

curl -i GET https://media.vyso.io/hue:value=90/ASSET_ID.jpg

Shift Hue by 180 Degrees (Opposite Colors)

curl -i GET https://media.vyso.io/hue:value=180/ASSET_ID.jpg

Shift Hue Backward by 60 Degrees

curl -i GET https://media.vyso.io/hue:value=-60/ASSET_ID.jpg

Full Rotation (360 Degrees, Back to Original)

curl -i GET https://media.vyso.io/hue:value=360/ASSET_ID.jpg

On 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

valueREQUIRED

Hue rotation angle in degrees. Accepted values:

  • Range: -360 to 360 (or higher/lower for multiple rotations)
  • 0 - No hue shift (default)
  • 30-90 - Subtle to moderate color shift
  • 180 - Inverted colors (opposite hue)
  • 360 - Full rotation (back to original)
  • Negative values (e.g., -60) - Rotate backward

Response

The API returns an image with all colors rotated along the hue spectrum. All colors shift by the same amount, maintaining the relative color relationships while creating entirely different color schemes. 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)

← Back to Transformations