Effects are set via the effects array on video elements. Each entry has a type and an optional intensity (0–100, defaults to 50). Only fields that differ from their defaults are shown.
Effects are only supported on video elements — not on image. The API returns 422 if you add effects to an image element.
Single effect
{
"width": 1920,
"height": 1080,
"elements": [
{
"type": "video",
"source_url": "https://cdn.example.com/clip.mp4",
"effects": [{ "type": "glitch", "intensity": 70 }]
}
]
}
Chroma key (green screen)
Remove a green background. Tune the HSL bounds via chroma_props (defaults shown below target a standard green screen).
{
"width": 1920,
"height": 1080,
"elements": [
{
"type": "video",
"source_url": "https://cdn.example.com/greenscreen.mp4",
"effects": [
{
"type": "chroma_key",
"intensity": 100,
"chroma_props": {
"hue_min": 60,
"hue_max": 180,
"sat_min": 0.3,
"sat_max": 1.0,
"lum_min": 0.2,
"lum_max": 0.9
}
}
]
}
]
}
Multiple effects
Stack effects on the same element.
{
"width": 1920,
"height": 1080,
"elements": [
{
"type": "video",
"source_url": "https://cdn.example.com/clip.mp4",
"effects": [
{ "type": "film_grain", "intensity": 40 },
{ "type": "scanlines", "intensity": 50 }
]
}
]
}
Film and retro
type | Description |
|---|
vintage | Aged film / vintage look |
polaroid | Polaroid-style frame |
portra | Kodak Portra emulation |
super8 | Super 8mm grain |
filmic | Cinematic tone |
film_grain | Dusty film grain |
film_burn | Film burn light leak |
vhs | VHS tape distortion |
vhs_overlay | VHS scanline overlay |
Glitch and digital
type | Description |
|---|
glitch | Digital glitch artifacts |
compression_glitch | MPEG/codec compression artifacts |
rgb_split | RGB channel separation |
chromatic_aberration | Color fringing at edges |
ghosting | Motion ghost trails |
displacement | Heavy displacement warp |
crt | CRT monitor curvature |
television | Old TV static |
scanlines | Animated scanlines |
Blur and lens
type | Description |
|---|
bokeh | Bokeh light circles |
bokeh_blur | Bokeh blur background |
box_blur | Uniform box blur |
pixelate | Block pixelation |
fisheye | Fisheye lens distortion |
viewfinder | Camera viewfinder frame |
Color and tone
type | Description |
|---|
invert | Invert colors |
posterize | Reduce color levels |
halftone | Halftone dot pattern |
night_vision | Green night vision |
thermal | Heat map colors |
prism | Prismatic color split |
Overlay and atmosphere
type | Description |
|---|
light_leaks | Film light leak overlay |
lens_flare | Lens flare streaks |
strobe | Strobing flash |
snow | Falling snow particles |
glow | Soft diffusion glow |
sepia | Warm sepia tone with vignette |
echo | Motion echo / double-exposure trail |
