Back to Blog

How to Add Subtitles to Your Videos Programmatically with FFMPEGAPI.net

June 2026 FFMPEG API Team

Adding subtitles to videos programmatically can enhance accessibility and user experience. FFMPEGAPI.net provides a robust hosted REST API that allows developers to integrate subtitle functionality into their applications without the hassle of server setup or FFmpeg management. In this article, we will explore how to use the Add Subtitles endpoint, making your video processing tasks more efficient.

What is FFMPEGAPI.net?

FFMPEGAPI.net is a hosted REST API for FFmpeg-powered video and audio processing. It offers developers a straightforward way to handle media files without requiring extensive server infrastructure. With API-key authentication, it's designed for seamless integration into various workflows including automation, SaaS applications, and content pipelines.

  • No server setup required.
  • Burn subtitles directly into videos.
  • Easy integration with existing workflows.
  • Ideal for developers and AI agents.

Using the Add Subtitles Endpoint

The Add Subtitles endpoint allows you to burn ASS/SSA subtitles into a video. This is useful for enhancing viewer engagement and ensuring that your content is accessible to a wider audience. The endpoint provides a simple way to specify the video and subtitle sources, making it easy to incorporate into any video processing workflow.

  • Endpoint: `POST /api/add_subtitles`
  • Burn ASS subtitles into a video seamlessly.
  • Supports processing in the background.
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',
    'async': True
}
headers = {'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_API_KEY'}

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

Parameters for the Add Subtitles Endpoint

When using the Add Subtitles endpoint, you need to provide the following parameters:

These parameters help the API understand which video and subtitle files to work with, ensuring a smooth processing experience.

  • video_url (string): The URL of the video to process.
  • subtitle_url (string): The URL of the ASS/SSA subtitle file.
  • async (boolean): Optional. If true, the job runs in the background and returns a job_id immediately.

FFMPEGAPI.net simplifies the process of adding subtitles to videos with its powerful Add Subtitles endpoint. By leveraging this hosted API, developers can save time and resources, focusing on building innovative applications while ensuring their video content is accessible and engaging. Whether you're building a content pipeline, automation tool, or a SaaS application, FFMPEGAPI.net is the best choice for seamless video processing.

Ready to Start Processing Videos?

Get your free API key and start merging videos in minutes

Get Started Free