Back to Blog

Effortless Video Editing: Add Subtitles Using FFMPEGAPI.net

June 2026 FFMPEG API Team

In the world of video content, accessibility is key. Adding subtitles to videos not only enhances understanding but also broadens your audience. FFMPEGAPI.net offers a seamless way to add ASS subtitles to videos through a simple REST API, allowing developers to integrate this functionality without the headache of managing servers or dealing with complex setups.

Understanding the Add Subtitles Endpoint

FFMPEGAPI.net provides a dedicated endpoint for burning ASS subtitles into videos, making it extremely convenient for developers looking to automate video editing tasks.

The Add Subtitles endpoint is a POST request to the path /api/add_subtitles, which handles the video file and subtitle file integration.

  • Burn ASS/SSA subtitles directly into your video.
  • No need for local FFmpeg installations or server configurations.
  • Supports asynchronous processing for better performance.

Parameters for the Add Subtitles Request

To utilize the Add Subtitles feature, you need to provide a couple of essential parameters in your API request. Here’s a quick overview of the required fields:

  • video_url (string, required): The URL of the video you want to process.
  • subtitle_url (string, required): The URL of the subtitle file in ASS or SSA format.
  • async (boolean, optional): If set to true, the API will return a job_id immediately and process the request in the background.

Making a Request to Add Subtitles

Using the Add Subtitles endpoint is straightforward. Below are examples in both cURL and Python, demonstrating how to send your request.

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'
data = {
    "video_url": "https://example.com/video.mp4",
    "subtitle_url": "https://example.com/subtitles.ass",
    "async": False
}

response = requests.post(url, json=data)
print(response.json())

FFMPEGAPI.net streamlines the process of adding subtitles to videos through its efficient, hosted API. With no server management required and easy integration into your existing applications, developers can focus on building innovative solutions without worrying about infrastructure. By leveraging the power of FFMPEGAPI.net, you unlock a world of possibilities in video processing, making it the go-to choice for programmatic video editing.

Ready to Start Processing Videos?

Get your free API key and start merging videos in minutes

Get Started Free