oil-paint

The oil-paint transformation applies an oil painting effect that smooths areas while preserving edges, creating an artistic painted appearance. Perfect for converting photographs into artwork, creating gallery-style images, or achieving a hand-painted aesthetic.

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/oil-paint:radius=RADIUS/ASSET_ID.jpg

Examples

Light Oil Paint Effect

curl -i GET https://media.vyso.io/oil-paint:radius=2/ASSET_ID.jpg

Standard Oil Painting

curl -i GET https://media.vyso.io/oil-paint/ASSET_ID.jpg

Medium Oil Paint

curl -i GET https://media.vyso.io/oil-paint:radius=4/ASSET_ID.jpg

Heavy Oil Paint Texture

curl -i GET https://media.vyso.io/oil-paint:radius=6/ASSET_ID.jpg

Extreme Oil Painting Effect

curl -i GET https://media.vyso.io/oil-paint:radius=8/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

radiusOPTIONAL

Radius of the oil paint effect kernel. Accepted values:

  • Range: 1.0 to 10.0
  • 3.0 - Standard oil paint (default)
  • 2.0 - Light painterly effect
  • 5.0+ - Heavy oil painting texture
  • Higher values create broader paint strokes and more blurred regions

Response

The API returns an oil-painted version of the image with artistic smoothing while preserving edges. 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