Back to Blog

Effortlessly Add Subtitles to Your Videos with FFMPEGAPI.net

June 2026 FFMPEG API Team

Adding subtitles to videos can enhance accessibility and improve user engagement. FFMPEGAPI.net offers a powerful, hosted REST API that simplifies this process by allowing developers to burn ASS subtitles directly into video files with just a few lines of code. In this article, we’ll explore how to use the 'Add Subtitles' endpoint to integrate this functionality into your applications seamlessly.

Understanding the Add Subtitles Endpoint

The Add Subtitles endpoint of FFMPEGAPI.net is a versatile tool that enables you to burn subtitles into your videos effortlessly. By using this API, developers can offload complex FFmpeg processing tasks without the need for server setup or infrastructure management.

  • Method: POST
  • Path: /api/add_subtitles
  • Content Type: application/json

Parameters Required for the API Call

To effectively use the Add Subtitles endpoint, you need to provide specific parameters. These parameters allow the API to locate your video and subtitle files and to process them accordingly.

  • video_url (string, required): The URL of the video you want to process.
  • subtitle_url (string, required): The URL of the ASS/SSA subtitle file.
  • async (boolean, optional): If true, the API returns a job_id immediately, allowing you to check the status of the processing in the background.

Making Your First API Call with cURL

Here’s how you can make an API call to add subtitles using cURL. This practical example demonstrates the simplicity and effectiveness of FFMPEGAPI.net.

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"}'

Integrating the API with Python

For those who prefer Python, integrating the FFMPEGAPI.net service is straightforward. Below is a Python example using the requests library to add subtitles to your video.

import requests

url = 'https://ffmpegapi.net/api/add_subtitles'
data = {
    'video_url': 'https://example.com/video.mp4',
    'subtitle_url': 'https://example.com/subtitles.ass'
}

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

FFMPEGAPI.net not only simplifies the process of adding subtitles to videos but also serves as an excellent cloud FFmpeg alternative for developers. With no server management and easy API key authentication, it's ideal for automation, SaaS applications, and content pipelines. Start utilizing the Add Subtitles endpoint today to enhance your video content effortlessly!

Ready to Start Processing Videos?

Get your free API key and start merging videos in minutes

Get Started Free