Media

Image Regional Effects

Apply visual effects to specific image regions: blur, grayscale, sepia, highlight, dim, transparency, etc. Supports rectangle, ellipse, and polygon shapes. Works with detection results. Inverse mode applies effects everywhere except regions. Note: Transparency effect requires PNG or WebP output format.

Category: Media · Plans: Trial, Pro, Premium, Enterprise · Type: ImageRegionalEffects

Inputs#

FieldTypeRequiredDefaultWhat it does
Image URLTextYes(empty)URL to the image to apply regional effects to.
Detection Results (JSON)TextNo(empty)JSON array with regions. Shapes: rectangle (bbox), ellipse (center, axes), polygon (points). Examples: [{“bbox”:{“x”:100,“y”:200,“width”:80,“height”:150}}] or [{“shape”:“ellipse”,“center”:{“x”:150,“y”:180},“axes”:{“width”:60,“height”:80}}] or [{“shape”:“polygon”,“points”:[{“x”:100,“y”:100},{“x”:200,“y”:150},{“x”:150,“y”:250}]}]
EffectTextNoblurVisual effect to apply to regions. Options: blur, grayscale, sepia, negative, highlight, dim, saturate, desaturate, solid_color, transparency
Blur Method (if effect=blur)TextNogaussianMethod for blur effect. Options: gaussian, pixelate, solid (Advanced)
Effect StrengthNumberNo0.5Strength/intensity of effect (meaning varies by effect type).
Inverse ModeYes/NoNoOffIf enabled, applies effect everywhere EXCEPT the specified regions.
Expand Regions (px)NumberNo10Expand region boundaries by pixels for better coverage. (Advanced)
Feather Edges (px)NumberNo20Smooth gradient transition at region edges. 0=sharp edge, higher=smoother blend. (Advanced)
Output FormatTextNojpgOutput image format. Options: jpg, png, webp (Advanced)

Outputs#

OutputType
Image UrlText
Regions ProcessedNumber
Effect AppliedText
Inverse ModeYes/No
StatusText
ErrorAny

Use as an agent tool#

Tool name: imageregionaleffects

Apply visual effects to specific image regions: blur, grayscale, sepia, highlight, dim, transparency, etc. Supports rectangle, ellipse, and polygon shapes. Works with detection results. Inverse mode applies effects everywhere except regions. Note: Transparency effect requires PNG or WebP output format.