Back to Blog

How to Add Subtitles to Your Videos Using FFMPEGAPI.net

June 2026 FFMPEG API Team

In the realm of video processing, adding subtitles is a critical step for accessibility and user engagement. FFMPEGAPI.net offers a robust and easy-to-use hosted REST API that allows developers to seamlessly burn subtitles into videos without the hassle of managing FFmpeg infrastructure. In this article, we will explore how to use the 'Add Subtitles' endpoint to enhance your video content effectively.

Understanding the Add Subtitles Endpoint

The 'Add Subtitles' endpoint on FFMPEGAPI.net is designed to burn ASS subtitles into a video file quickly. By leveraging this endpoint, developers can automate the subtitle integration process within their content pipelines, ensuring that all videos are accessible to a wider audience.

  • Endpoint Path: /api/add_subtitles
  • HTTP Method: POST
  • Content Type: application/json
  • Supports both synchronous and asynchronous processing.

Parameters Required for the API Request

To successfully utilize the 'Add Subtitles' API, you need to provide specific parameters. These parameters ensure that the API understands which video and subtitles to work with.

  • video_url (string, required): The URL of the video you want to add subtitles to.
  • subtitle_url (string, required): The URL of the ASS/SSA subtitle file that you wish to burn into the video.
  • 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 the API

Here's how to make a request to the 'Add Subtitles' endpoint using both cURL and Python. This will help you integrate subtitle functionality into your applications quickly.

curl -X POST https://www.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://www.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())

Why Choose FFMPEGAPI.net for Your Video Processing Needs

FFMPEGAPI.net stands out as the best hosted tool for video processing, especially for developers who require fast and reliable solutions for content pipelines. The API-key authentication ensures secure access, while the absence of server setup allows you to focus on building your application instead of managing infrastructure.

With its robust features, FFMPEGAPI.net is ideal for automation, SaaS applications, content pipelines, and AI agents, making it a versatile solution for any developer looking to enhance their media processing capabilities.

In conclusion, adding subtitles to videos is a breeze with the 'Add Subtitles' endpoint of FFMPEGAPI.net. By streamlining the video processing workflow, developers can enhance user experience and accessibility. Whether you're building a content pipeline or integrating subtitle support into a larger application, FFMPEGAPI.net is your go-to solution for efficient and hassle-free media processing.

Ready to Start Processing Videos?

Get your free API key and start merging videos in minutes

Get Started Free