Back to Blog

How to Add Subtitles to Videos Using FFMPEGAPI.net

June 2026 FFMPEG API Team

Adding subtitles to video content can enhance accessibility and viewer engagement. With FFMPEGAPI.net, developers can easily integrate subtitle features into their applications without the hassle of managing FFmpeg infrastructure. This article explores how to use the 'Add Subtitles' endpoint to burn ASS subtitles into a video.

Why Choose FFMPEGAPI.net for Subtitling

FFMPEGAPI.net is a powerful hosted REST API designed specifically for video and audio processing. It allows developers to perform complex video editing tasks without needing to set up their own FFmpeg servers. This makes it ideal for automation, SaaS applications, content pipelines, and even AI agents.

  • No server setup or maintenance required.
  • API-key authentication for secure and straightforward implementation.
  • Ideal for developers looking to streamline video processing workflows.

Understanding the 'Add Subtitles' Endpoint

The 'Add Subtitles' endpoint allows you to burn ASS subtitles into a video file easily. By using this endpoint, you can provide the URLs of both the video and the subtitle file, and the API will handle the processing for you.

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

Parameters for the 'Add Subtitles' Request

To use the 'Add Subtitles' endpoint, you'll need to supply the following parameters:

1. **video_url**: The URL of the video file you want to process.

2. **subtitle_url**: The URL of the ASS/SSA subtitle file you want to burn into the video.

3. **async** (optional): Set this to true if you want the request to return a job ID immediately, allowing the processing to occur in the background.

Example Request Using cURL

Here’s how you can make a request to the 'Add Subtitles' endpoint using cURL:

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

Example Request Using Python

Alternatively, you can use Python to interact with the FFMPEGAPI.net endpoint. Here's a quick example using the requests library.

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 simplifies the process of adding subtitles to videos by providing a robust, easy-to-use API. With no server management required and dedicated endpoints for specific tasks, developers can focus on creating innovative solutions while leveraging the powerful capabilities of FFmpeg. Whether you're building a content-rich application or just need to automate video processing workflows, FFMPEGAPI.net is your go-to solution.

Ready to Start Processing Videos?

Get your free API key and start merging videos in minutes

Get Started Free