How to Add Static Overlays to Videos in Workflows

To add an image or watermark to a video, just use the Add Image Overlay tool. Otherwise, use Workflows to burn logos, watermarks, badges, or borders on your videos and chain them with other Bannerbear operations.

For this example, we'll burn the Bannerbear logo into a video.

Inputs

Create a new Workflow and use the + Add Input button to declare your inputs. These are the parameters that you supply to the API when you run your workflow.

🐻 Bear Tip: Available inputs can be found on the Add Image Overlay tool page and the API parameters can be found on the API Reference page.

Each input has:

• name - used as references in your workflows and API requests
• type - the type of input you're supplying
  • text       
  • url       
  • number       
  • boolean    
• required - determines whether a run must supply this input

Image Overlay

Add a Tool step and select Add image overlay from the drop-down menu. Use the + ref button to select the appropriate input references.

In the example below, our inputs are:

• base - for the video we're overlaying onto
• overlay - for the logo overlay
• margin - to define the gap from the edge of the video
• opacity - to define the opacity of the logo

🐻 Bear Tip: A step's inputs can reference a workflow input as {{inputs.<name>}}  or an earlier step's output as {{steps.<key>.<output>}} .

API Workflow Run

Send a POST request to the /v5/workflow_runs  endpoint, along with your workflow UID and your inputs. May also be sent as a bare top-level object instead of nested under input.

var data = {
  "workflow": "VymBYa7gMjW6JQ2njM",
  "inputs": {
    "base": "https://www.bannerbear.com/video/webcam_example.mov",
    "logo": "image_url.png",
    "margin": 25,
    "opacity": 0.7
  }
}
fetch('https://api.bannerbear.com/v5/workflow_runs', {
  method: 'POST',
  body: JSON.stringify(data),
  headers: {
    'Content-Type' : 'application/json',
    'Authorization' : `Bearer ${API_KEY}`
  }
})

🐻 Bear Tip: Workflows can be created via the API as well. See Create a Workflow for more.