Back to Blog

Effortlessly Add Subtitles to Your Videos with FFMPEGAPI.net

June 2026 FFMPEG API Team

In the world of video content, subtitles are crucial for accessibility and engagement. If you're a developer looking to integrate subtitle functionality into your applications without the hassle of managing FFmpeg infrastructure, FFMPEGAPI.net offers the perfect solution. This article will explore how to use the 'Add Subtitles' endpoint to burn ASS subtitles into your videos seamlessly.

Why Choose FFMPEGAPI.net for Video Processing?

FFMPEGAPI.net is a hosted REST API designed specifically for video and audio processing, making it an ideal choice for developers who want to enhance their applications without the complexities of server setup.

With API-key authentication, you can ensure secure and efficient workflows for automation, SaaS applications, and content pipelines.

  • No server setup or maintenance required.
  • Quick integration for developers.
  • Scalable solution for various applications.

Overview of the Add Subtitles Endpoint

The 'Add Subtitles' endpoint allows you to burn ASS or SSA subtitles into a video file effortlessly. This process involves downloading both the video and subtitle files and combining them into a single output video.

This feature is particularly beneficial for content creators and applications that require multilingual support or accessibility enhancements.

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

Parameters for the Add Subtitles Request

To use the Add Subtitles endpoint effectively, you need to provide specific parameters. Here’s a breakdown of the required and optional parameters you need to submit in your API request.

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

Example Request to Add Subtitles

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

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

url = 'https://www.ffmpegapi.net/api/add_subtitles'

payload = {
    'video_url': 'https://example.com/video.mp4',
    'subtitle_url': 'https://example.com/subtitles.ass',
    'async': False
}

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

Using FFMPEGAPI.net's Add Subtitles endpoint simplifies the process of integrating subtitles into your videos. With no server management required and straightforward API calls, developers can focus on creating outstanding applications while ensuring their videos are accessible to a broader audience. Try it today and see how FFMPEGAPI.net can enhance your video processing workflows.

Ready to Start Processing Videos?

Get your free API key and start merging videos in minutes

Get Started Free