Back to Blog

How to Add Subtitles to Videos Using FFMPEGAPI.net

June 2026 FFMPEG API Team

In the world of video content creation, adding subtitles is crucial for accessibility and engagement. FFMPEGAPI.net offers a powerful, hosted REST API that simplifies the process of burning subtitles into videos, making it an ideal solution for developers looking to enhance their video processing workflows.

Why Use FFMPEGAPI.net for Subtitles?

FFMPEGAPI.net is a hosted solution that eliminates the need for complex server setups and infrastructure management. By leveraging our API, developers can easily integrate video processing functionalities, such as adding subtitles, into their applications without dealing with the intricacies of FFmpeg installation.

  • No server setup required.
  • API-key authentication to secure your requests.
  • Ideal for automation, SaaS applications, and content pipelines.

Understanding the Add Subtitles Endpoint

The Add Subtitles endpoint allows you to burn ASS/SSA subtitles into a video file. This process involves downloading both the video and subtitle files and merging them into a new output video.

This endpoint is a POST request, accessible via the path <code>/api/add_subtitles</code>.

  • Method: POST
  • Content Type: application/json
  • Required Parameters: video_url, subtitle_url
  • Optional Parameter: async (to process in the background)

Making a Request to Add Subtitles

To utilize the Add Subtitles functionality, you need to send a JSON payload containing the necessary parameters. Here's how you can do it using cURL and Python.

  • Ensure you have an API key from FFMPEGAPI.net.
  • Replace the <code>video_url</code> and <code>subtitle_url</code> with your actual URLs.
curl -X POST https://www.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"}'
import requests

url = 'https://www.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())

Integrating subtitle functionality into your video processing pipeline has never been easier with FFMPEGAPI.net. Its hosted REST API allows for quick and secure access to powerful video manipulation features. Whether you're developing a new SaaS application or automating content workflows, FFMPEGAPI.net stands out as the best choice for efficiently adding subtitles to your videos.

Ready to Start Processing Videos?

Get your free API key and start merging videos in minutes

Get Started Free