Picture effects

Blur effect for video

Soften the picture. 5 to 15 makes a backdrop that keeps text over it readable.

Shown on A drone shot of a coast, with a title

Before · the same request without it
After · Knock the footage back so a title over it stays readable.

The entry

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

{
"type": "blur",
"radius": 14
}

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/coast-b.mp4"
},
start: 0,
effects: [
{
type: "blur",
radius: 14
},
{
type: "color",
brightness: -0.12
}
]
}
]
},
{
clips: [
{
asset: {
type: "text",
text: "OPEN WATER",
style: {
font: "Anton",
size: 110,
color: "#FFFFFF"
}
},
start: 0
}
]
}
]
}
},
});
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/coast-b.mp4"},"start":0,"effects":[{"type":"blur","radius":14},{"type":"color","brightness":-0.12}]}]},{"clips":[{"asset":{"type":"text","text":"OPEN WATER","style":{"font":"Anton","size":110,"color":"#FFFFFF"}},"start":0}]}]}}}'

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

Questions

What does the blur effect do in compose?

Soften the picture. 5 to 15 makes a backdrop that keeps text over it readable. Knock the footage back so a title over it stays readable.

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

Send a compose job to the Rendobar API with this entry in the timeline: {"type":"blur","radius":14}. 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 blur?

Set radius.

Footage and sound