Picture effects

Color grading effect for video

Grade the picture by hand. Every parameter is optional, and one left out leaves that quality unchanged.

Shown on A woman on forest steps

Before · the same request without it
After · A warm cinematic grade: the light pulled towards gold, contrast and color lifted a little, skin left believable.

The entry

Add it to a clip's effects list. Entries run in the order you write them.

{
  "type": "color",
  "temperature": 5200,
  "contrast": 1.18,
  "saturation": 1.12,
  "brightness": 0.04
}

Every setting and default is in the docs

Run it

The whole request behind the render above. Paste it as it is, or swap the file for your own.

job.ts
import { createClient, outputUrl } from "@rendobar/sdk";


const rb = createClient({ apiKey: process.env.RENDOBAR_API_KEY });


const job = await rb.jobs.run({
  type: "compose",
  params: {
    schemaVersion: 1,
    output: {
      format: "mp4",
      resolution: {
        width: 960,
        height: 540
      }
    },
    timeline: {
      tracks: [
        {
          clips: [
            {
              asset: {
                type: "video",
                src: "https://cdn.rendobar.com/compose/showcase/media/steps.mp4"
              },
              start: 0,
              effects: [
                {
                  type: "color",
                  temperature: 5200,
                  contrast: 1.18,
                  saturation: 1.12,
                  brightness: 0.04
                }
              ]
            }
          ]
        }
      ]
    }
  },
});


console.log(outputUrl(job));

Install with npm i @rendobar/sdk. jobs.run() submits and waits, so it returns the finished job in one call.

terminal
curl https://api.rendobar.com/jobs \
  -H "Authorization: Bearer $RENDOBAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"compose","params":{"schemaVersion":1,"output":{"format":"mp4","resolution":{"width":960,"height":540}},"timeline":{"tracks":[{"clips":[{"asset":{"type":"video","src":"https://cdn.rendobar.com/compose/showcase/media/steps.mp4"},"start":0,"effects":[{"type":"color","temperature":5200,"contrast":1.18,"saturation":1.12,"brightness":0.04}]}]}]}}}'

Returns immediately with a job id. Poll GET /jobs/{id} or register a webhook rather than blocking on the request.

Questions

What does the color effect do in compose?

Grade the picture by hand. Every parameter is optional, and one left out leaves that quality unchanged. A warm cinematic grade: the light pulled towards gold, contrast and color lifted a little, skin left believable.

How do I add color to a video with an API?

Send a compose job to the Rendobar API with this entry in the timeline: {"type":"color","temperature":5200,"contrast":1.18,"saturation":1.12,"brightness":0.04}. Add it to a clip's effects list. Entries run in the order you write them. The request on this page is complete and renders as shown.

What are the default settings for color?

Set at least one of brightness, contrast, saturation, gamma, hue, or temperature. Any you leave out stay neutral.

Footage and sound

More features

Chroma key Remove the green screen so the presenter stands in front of a new background. Looks The whole archive look in one word: sepia, grain, dust, scratches, projector flicker and a vignette together. Blur Knock the footage back so a title over it stays readable. Sharpen Crisp up footage that is slightly out of focus. Look at the jacket, the hair and the stone. Denoise Clean the grain a small sensor adds in the dark. Punched in so the grain is actually visible at this size, because at full width it is too fine to see. Glow Make the lights bloom on a city at night.

See all 117 features →