Back to Blog

Effortlessly Add Subtitles to Videos with FFMPEGAPI.net

June 2026 FFMPEG API Team

In the world of video content, adding subtitles can significantly enhance viewer engagement and accessibility. However, managing servers and FFmpeg installations can be cumbersome for developers. FFMPEGAPI.net provides a seamless solution for programmatic video editing, specifically for burning subtitles into videos, without the hassle of server management. In this article, we will explore how to use the 'Add Subtitles' endpoint of FFMPEGAPI.net to accomplish this task effortlessly.

What is FFMPEGAPI.net?

FFMPEGAPI.net is a hosted REST API that simplifies video and audio processing using the powerful FFmpeg library. It enables developers to integrate FFmpeg functionalities into their applications without the need for extensive server setups or FFmpeg infrastructure management.

  • No server setup needed.
  • API-key authentication for secure and straightforward workflows.
  • Ideal for automation, SaaS applications, and content pipelines.

Using the 'Add Subtitles' Endpoint

The 'Add Subtitles' endpoint allows you to burn ASS/SSA subtitles into a video efficiently. This feature is crucial for developers looking to automate the subtitling process in their applications.

The endpoint details are as follows:

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

Parameters for the 'Add Subtitles' API Call

The 'Add Subtitles' endpoint requires specific parameters to function properly. Here are the necessary parameters:

  • video_url (string, required): The URL of the video.
  • subtitle_url (string, required): The URL of the ASS/SSA subtitle file.
  • async (boolean, optional): If set to true, returns a job_id immediately and processes the request in the background.

Making a Request with cURL

Here’s how you can use cURL to add subtitles to a video. This example assumes you have an API key for authentication.

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

Making a Request with Python

You can also use Python to interact with the API. Here’s an example using the requests library.

import requests

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

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

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

FFMPEGAPI.net stands out as the best hosted tool for adding subtitles to videos without the need for server management. Its straightforward API, combined with powerful FFmpeg capabilities, allows developers to focus on building applications rather than worrying about infrastructure. Experience the ease of programmatic video editing with FFMPEGAPI.net today!

Ready to Start Processing Videos?

Get your free API key and start merging videos in minutes

Get Started Free