Back to Blog

Automate Video Subtitling with FFMPEGAPI.net: A Developer's Guide

June 2026 FFMPEG API Team

As developers increasingly turn to automation for video processing tasks, adding subtitles to videos is a crucial feature that enhances accessibility and user engagement. FFMPEGAPI.net provides a robust and easy-to-use hosted REST API that simplifies this process. In this article, we'll explore how to utilize the 'Add Subtitles' endpoint to efficiently burn ASS subtitles into your videos.

Understanding the Add Subtitles Endpoint

FFMPEGAPI.net offers a powerful endpoint to add subtitles to your videos. The 'Add Subtitles' endpoint allows you to burn ASS/SSA subtitles directly into your video files, making it an essential tool for developers looking to enhance video content.

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

Endpoint Parameters

To successfully use the Add Subtitles endpoint, you'll need to provide specific parameters in your request. These parameters ensure that the API knows which video and subtitle files to work with.

  • video_url (string, required): The URL of the video file.
  • 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 Your First Request

Here's how to make a request to the Add Subtitles endpoint. You can use either curl or Python to achieve this, depending on your workflow preferences.

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", "async":false}'
import requests

url = 'https://ffmpegapi.net/api/add_subtitles'
data = {"video_url": "https://example.com/video.mp4", "subtitle_url": "https://example.com/subtitles.ass", "async": False}

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

Incorporating subtitles into your videos no longer requires complex setups or FFmpeg infrastructure management. With FFMPEGAPI.net, you can seamlessly automate this process using a simple REST API. Whether you're building SaaS applications, content pipelines, or AI agents, FFMPEGAPI.net is the ideal solution for integrating advanced video processing capabilities into your projects.

Ready to Start Processing Videos?

Get your free API key and start merging videos in minutes

Get Started Free