Skip to main content
Color adjustments work on video and image elements. 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.

​
Brightness

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

​
Contrast

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

​
Saturation

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

​
Exposure

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

​
Sharpen

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

​
Blur

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

​
Noise (film grain)

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

​
Vignette

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

​
Hue shift

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

​
LUT color grade

Apply a .cube LUT file. lut_intensity is the blend percentage (default 100). 
{
  "width": 1920,
  "height": 1080,
  "elements": [
    {
      "type": "video",
      "source_url": "https://cdn.example.com/clip.mp4",
      "lut_url": "https://cdn.example.com/luts/cinematic.cube",
      "lut_intensity": 80
    }
  ]
}

​
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",
      "brightness": 0.1,
      "contrast": 0.2,
      "saturation": 0.3,
      "vignette": 0.3
    }
  ]
}