Color Adjustments

Color adjustments work on video and image elements — except lut_url, which is video-only (see below). All adjustment values default to 0. Only fields that differ from their defaults are shown.

For image elements, both id and duration are required — the API returns 422 if either is missing. See the element field reference for all defaults.Each video element below sets out_point. A source_url Framelane does not host is rejected at submit with 422 invalid_source without one — and the dry run reports ok: true regardless.

Brightness

{
  "width": 1920,
  "height": 1080,
  "elements": [
    {
      "type": "video",
      "source_url": "https://cdn.example.com/clip.mp4",
      "out_point": 6,
      "brightness": 0.3
    }
  ]
}

Contrast

{
  "width": 1920,
  "height": 1080,
  "elements": [
    {
      "type": "video",
      "source_url": "https://cdn.example.com/clip.mp4",
      "out_point": 6,
      "contrast": 0.4
    }
  ]
}

Saturation

{
  "width": 1920,
  "height": 1080,
  "elements": [
    {
      "type": "video",
      "source_url": "https://cdn.example.com/clip.mp4",
      "out_point": 6,
      "saturation": 0.5
    }
  ]
}

Exposure

{
  "width": 1920,
  "height": 1080,
  "elements": [
    {
      "type": "video",
      "source_url": "https://cdn.example.com/clip.mp4",
      "out_point": 6,
      "exposure": 0.2
    }
  ]
}

Sharpen

{
  "width": 1920,
  "height": 1080,
  "elements": [
    {
      "type": "video",
      "source_url": "https://cdn.example.com/clip.mp4",
      "out_point": 6,
      "sharpness": 0.3
    }
  ]
}

Blur

{
  "width": 1920,
  "height": 1080,
  "elements": [
    {
      "type": "video",
      "source_url": "https://cdn.example.com/clip.mp4",
      "out_point": 6,
      "blur": 0.5
    }
  ]
}

Noise (film grain)

{
  "width": 1920,
  "height": 1080,
  "elements": [
    {
      "type": "video",
      "source_url": "https://cdn.example.com/clip.mp4",
      "out_point": 6,
      "noise": 0.3
    }
  ]
}

Vignette

{
  "width": 1920,
  "height": 1080,
  "elements": [
    {
      "type": "video",
      "source_url": "https://cdn.example.com/clip.mp4",
      "out_point": 6,
      "vignette": 0.4
    }
  ]
}

Hue shift

{
  "width": 1920,
  "height": 1080,
  "elements": [
    {
      "type": "video",
      "source_url": "https://cdn.example.com/clip.mp4",
      "out_point": 6,
      "hue_rotate": 45
    }
  ]
}

LUT color grade

Apply a .cube LUT file. lut_intensity is the blend percentage (default 100).

lut_url / lut_intensity are honored on video elements only. They are accepted on an image element and then silently dropped — no error, no LUT. Grade a still with temperature / tint / vibrance / highlights / shadows instead.

{
  "width": 1920,
  "height": 1080,
  "elements": [
    {
      "type": "video",
      "source_url": "https://cdn.example.com/clip.mp4",
      "out_point": 6,
      "lut_url": "https://cdn.example.com/luts/cinematic.cube",
      "lut_intensity": 80
    }
  ]
}

Parametric grade

Five controls that run after the classic brightness/contrast chain. Range −1 to 1, 0 = no-op. They are not clamped — the engine renders out-of-range values linearly. Unlike lut_url, these work on image elements too.

Field	What it does
`temperature`	White balance warm (+) / cool (−)
`tint`	White balance magenta (+) / green (−)
`vibrance`	Saturation boost weighted toward muted colors — lifts flat color without wrecking skin tones
`highlights`	Luma-masked tone lift of the brightest range
`shadows`	Luma-masked tone lift of the darkest range

{
  "width": 1920,
  "height": 1080,
  "elements": [
    {
      "type": "video",
      "source_url": "https://cdn.example.com/clip.mp4",
      "out_point": 6,
      "temperature": 0.25,
      "tint": -0.1,
      "vibrance": 0.4,
      "highlights": -0.2,
      "shadows": 0.15
    }
  ]
}

Combined adjustments

Multiple adjustments can be set on the same element.

{
  "width": 1920,
  "height": 1080,
  "elements": [
    {
      "type": "video",
      "source_url": "https://cdn.example.com/clip.mp4",
      "out_point": 6,
      "brightness": 0.1,
      "contrast": 0.2,
      "saturation": 0.3,
      "vignette": 0.3
    }
  ]
}

Get Started

Renders

Render Examples

Recipes

Tasks

Webhooks

SDKs

Brightness

Contrast

Saturation

Exposure

Sharpen

Blur

Noise (film grain)

Vignette

Hue shift

LUT color grade

Parametric grade

Combined adjustments

​Brightness

​Contrast

​Saturation

​Exposure

​Sharpen

​Blur

​Noise (film grain)

​Vignette

​Hue shift

​LUT color grade

​Parametric grade

​Combined adjustments

Brightness

Contrast

Saturation

Exposure

Sharpen

Blur

Noise (film grain)

Vignette

Hue shift

LUT color grade

Parametric grade

Combined adjustments