How to add Subtitles to Videos

Use Workflows to auto-transcribe audio and burn styled subtitles onto videos. 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.

Note: 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

Note: 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.

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.

Note: Some parameters can't be reference, 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. May also be sent as a bare top-level object instead of nested under input.

var data = {
  "workflow": "VymBYa7gMjW6JQ2njM",
  "inputs": {
    "video_url": "https://cdn.bannerbear.com/sample_videos/clip.mp4",
    "title_text": "New Arrival"
  }
}
fetch('https://api.bannerbear.com/v5/workflow_runs', {
  method: 'POST',
  body: JSON.stringify(data),
  headers: {
    'Content-Type' : 'application/json',
    'Authorization' : `Bearer ${API_KEY}`
  }
})

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