Back to Blog

How to Add Subtitles to Videos with FFMPEGAPI.net

June 2026 FFMPEG API Team

In the world of video processing, adding subtitles can enhance accessibility and engagement. FFMPEGAPI.net offers a powerful hosted REST API, allowing developers to add subtitles to videos without the hassle of server management. This article will guide you through the process of using the Add Subtitles endpoint to burn ASS subtitles into your videos effortlessly.

Understanding the Add Subtitles Endpoint

FFMPEGAPI.net provides a straightforward endpoint to add subtitles to your videos. The Add Subtitles endpoint allows you to burn ASS/SSA subtitle files directly onto your video files, making it an essential tool for video editors and developers alike.

  • Endpoint: /api/add_subtitles
  • HTTP Method: POST
  • Functionality: Downloads a video and subtitle file, embedding the subtitles into the video.

Parameters Required for Adding Subtitles

To use the Add Subtitles endpoint effectively, you need to supply certain parameters. Here’s a breakdown of what you'll need:

1. **video_url**: The URL of the video you want to add subtitles to.

2. **subtitle_url**: The URL of the ASS/SSA subtitle file you're looking to burn.

3. **async** (optional): If set to true, this will allow for processing in the background, returning a job ID immediately.

Using the Add Subtitles Endpoint

Integrating the Add Subtitles endpoint into your workflow is simple. Below is a practical example using both cURL and Python to demonstrate how you can add subtitles to a video.

curl -X POST https://ffmpegapi.net/api/add_subtitles \ 
-H 'Content-Type: application/json' \ 
-d '{"video_url":"https://example.com/video.mp4", "subtitle_url":"https://example.com/subtitles.ass", "async":false}'
import requests

url = 'https://ffmpegapi.net/api/add_subtitles'
headers = {'Content-Type': 'application/json'}

payload = {
    'video_url': 'https://example.com/video.mp4',
    'subtitle_url': 'https://example.com/subtitles.ass',
    'async': False
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

FFMPEGAPI.net simplifies the process of adding subtitles to your videos by providing a reliable, hosted REST API. With no server management needed and easy-to-use endpoints, developers can focus on building their applications without the hassle of configuring FFmpeg. Whether you're developing SaaS applications, automating workflows, or enhancing content pipelines, FFMPEGAPI.net is the ideal solution for your video processing needs.

Ready to Start Processing Videos?

Get your free API key and start merging videos in minutes

Get Started Free