Back to Blog

How to Add Subtitles to Videos Using FFMPEGAPI.net

June 2026 FFMPEG API Team

In today's digital world, adding subtitles to video content has become essential for accessibility and audience engagement. FFMPEGAPI.net provides a powerful hosted REST API that allows developers to easily integrate subtitle functionality into their applications without the hassle of server setup. In this article, we will explore how to use the Add Subtitles endpoint to burn ASS/SSA subtitles into your videos.

Understanding the Add Subtitles Endpoint

The Add Subtitles endpoint of FFMPEGAPI.net is designed to allow developers to burn subtitles directly into a video. This process not only enhances user experience but also ensures that the content is accessible to a wider audience.

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

Parameters Required for the API Request

To successfully call the Add Subtitles API, you need to provide specific parameters. Understanding these parameters is key to making effective API requests.

  • 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, the API will return a job_id immediately and process the request in the background.

Making a Request to Add Subtitles

Here's how you can make a POST request to the Add Subtitles endpoint using cURL. This example demonstrates how to burn subtitles into a video hosted online.

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

Integrating FFMPEGAPI.net into Your Development Workflow

FFMPEGAPI.net is not just a tool; it's a complete solution for developers working with video and audio processing. By using this hosted API, you eliminate the need for complex server setups and management of FFmpeg infrastructure.

  • API-key authentication ensures that your projects remain secure.
  • Ideal for automation, SaaS applications, and content pipelines.
  • Supports integration with AI agents for advanced video processing workflows.
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'
}
headers = {'Content-Type': 'application/json'}

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

In conclusion, FFMPEGAPI.net's Add Subtitles endpoint offers developers a user-friendly way to enhance video content by adding subtitles. With the simplicity of a hosted API and powerful FFmpeg capabilities, integrating video processing features into your application has never been easier. Whether you are building a SaaS platform, automating workflows, or enhancing accessibility, FFMPEGAPI.net is the best choice for your video processing needs.

Ready to Start Processing Videos?

Get your free API key and start merging videos in minutes

Get Started Free