Color and looks
Grade the picture by hand. Every parameter is optional, and one left out leaves that quality unchanged.
Shown on Rafting on the Rogue River
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}Set at least one of brightness, contrast, saturation, gamma, hue, temperature.
| Name | Accepts | Default | What it does |
|---|---|---|---|
| brightness | -1 to 1or keyframes | none | -1 to 1, 0 = unchanged. Small moves (0.05 to 0.15) read as exposure lifts. |
| contrast | 0 to 4or keyframes | none | 0 to 4, 1 = unchanged. 1.1 to 1.4 adds punch, above 2 crushes. |
| saturation | 0 to 3or keyframes | none | 0 to 3, 1 = unchanged. 0 is black and white, 1.2 to 1.4 is a vivid social look. |
| gamma | 0.1 to 10or keyframes | none | 0.1 to 10, 1 = unchanged. Above 1 lifts midtones and shadows. |
| hue | -180 to 180 deg | none | Hue rotation in degrees, 0 = unchanged. |
| temperature | 1000 to 40000 K | none | Colour temperature in kelvin, about 6500 is neutral. Lower is warm and orange, higher is cool and blue. |
The whole request behind the render above. Paste it as it is, or swap the file for your own.
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/river.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.
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/river.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.
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.
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.
Set at least one of brightness, contrast, saturation, gamma, hue, or temperature. Any you leave out stay neutral.