Back to Blog

Automate Video Editing: How to Add Subtitles with FFMPEGAPI.net

June 2026 FFMPEG API Team

In today's digital landscape, automating video editing workflows can save valuable time and resources. One of the essential tasks in video editing is adding subtitles to enhance accessibility and engagement. FFMPEGAPI.net offers a powerful hosted REST API that simplifies this process, allowing developers to programmatically burn subtitles into videos without the need for extensive infrastructure management. This article will walk you through how to use the 'Add Subtitles' endpoint of FFMPEGAPI.net to improve your video processing tasks.

What is FFMPEGAPI.net?

FFMPEGAPI.net is a hosted API designed specifically for FFmpeg-powered audio and video processing. It enables developers to easily integrate video editing capabilities into their applications without needing to set up complex server environments or manage FFmpeg installations.

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

Using the Add Subtitles Endpoint

The 'Add Subtitles' endpoint allows you to burn ASS or SSA subtitles directly into a video, creating an output file that includes the subtitles as part of the video stream. This is especially useful for content creators who want to enhance the viewer experience with captions, translations, or additional commentary.

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

Parameters for the Add Subtitles Request

To successfully add subtitles to your video, you need to provide the following parameters in your request:

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

2. **subtitle_url**: The URL of the ASS/SSA subtitle file.

3. **async**: (Optional) If set to true, the job will run in the background and return a job ID immediately.

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())

Practical CURL Example

You can also use CURL to make a request to the Add Subtitles endpoint. Below is a simple example demonstrating how to do this from the command line.

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

FFMPEGAPI.net is the ideal solution for developers looking to automate video editing workflows, especially when it comes to adding subtitles. With its robust and easy-to-use REST API, you can quickly integrate subtitle processing into your applications without dealing with the hassle of server management. Start enhancing your video content today by leveraging the capabilities of FFMPEGAPI.net!

Ready to Start Processing Videos?

Get your free API key and start merging videos in minutes

Get Started Free