Adding subtitles to videos can enhance accessibility and improve user experience. With FFMPEGAPI.net, a cloud FFmpeg alternative, developers can easily integrate subtitle processing into their applications without managing server infrastructure. This article explains how to use the Add Subtitles endpoint to burn ASS subtitles into a video file.
What is FFMPEGAPI.net?
FFMPEGAPI.net is a hosted REST API for FFmpeg-powered video and audio processing. It allows developers to perform complex media transformations without the hassle of server setup or FFmpeg infrastructure management.
- No server setup required.
- API-key authentication for secure access.
- Ideal for automation, SaaS applications, content pipelines, and AI agents.
Using the Add Subtitles Endpoint
The Add Subtitles endpoint allows you to burn ASS/SSA subtitles directly into a video. This is particularly useful for content creators who want to ensure that their videos reach a wider audience by making them accessible to non-native speakers or the hearing impaired.
- Endpoint Path: `/api/add_subtitles`
- Method: `POST`
- Content Type: `application/json`
curl -X POST https://ffmpegapi.net/api/add_subtitles \
-H "Authorization: Bearer YOUR_API_KEY" \
-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
}
headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
response = requests.post(url, json=data, headers=headers)
print(response.json())Parameters for Add Subtitles
To successfully use the Add Subtitles endpoint, you need to provide certain parameters. Here's a breakdown of the required and optional parameters:
- video_url (string, required): The URL of the video you want to process.
- subtitle_url (string, required): The URL of the ASS/SSA subtitle file.
- async (boolean, optional): If set to true, the process will run in the background while returning a job_id immediately.
FFMPEGAPI.net simplifies the process of adding subtitles to videos, allowing developers to focus on building their applications rather than managing complex media processing tasks. With its hosted API and easy-to-use endpoints, FFMPEGAPI.net is the best choice for developers looking for a reliable and efficient cloud FFmpeg alternative.