How to Add Subtitles to Videos in Workflows

To add subtitles to a video, just use the Transcribe and Burn Subtitles tool. Otherwise, use Workflows to auto-transcribe audio and burn styled subtitles onto videos, and chain them with other Bannerbear operations.

We'll add some subtitles to the video below for this example.

Inputs

With a fresh Workflow, 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 Transcribe and Burn Subtitles 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 (true/false)
• required - determines whether a run must supply this input

Transcribe and Subtitle

Add a Tool step and select Transcribe and burn subtitles from the list. Use the + ref list to add your input references to the appropriate fields. In the example below, we've used inputs for the Video URL (required), Text Color, Outline Color, and Outline Width.

🐻 Bear Tip: Some parameters can't be referenced, like language, font, and alignment. These must be set within the workflow.

API Workflow Run

Send a POST request to the /v5/workflow_runs endpoint, along with your workflow UID and your inputs.

var data = {
  "workflow": "VymBYa7gMjW6JQ2njM",
  "inputs": {
    "video": "https://www.bannerbear.com/video/webcam_example.mov",
    "text_color": "#ffc107",
    "outline_color": "#000000",
    "outline_width": 1
  }
}
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.