In today’s fast-paced digital landscape, adding subtitles to video content has become essential for accessibility and audience engagement. FFMPEGAPI.net offers a powerful hosted REST API that simplifies the process of burning subtitles into your videos. This article walks you through how to use the Add Subtitles endpoint, making it an invaluable tool for developers and content creators alike.
Understanding the Add Subtitles Endpoint
The Add Subtitles endpoint is a straightforward way to incorporate ASS/SSA subtitles into your video files. By leveraging the capabilities of FFMPEG, you can automate this process without the hassle of managing your own FFmpeg infrastructure.
The POST request to the `/api/add_subtitles` path requires both a video URL and a subtitle file URL, making it easy to integrate into your existing workflows.
- Burn ASS subtitles into videos quickly
- No server setup or FFmpeg management required
- API-key authentication ensures secure use
Parameters for the API Request
When using the Add Subtitles endpoint, you'll need to provide specific parameters to ensure the process runs smoothly. Here are the required and optional parameters for your API request.
- 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 you want to burn into the video.
- async (boolean, optional): Set to true to receive a job ID immediately and process the video in the background.
Making Your First API Call
Here’s how you can use cURL to add subtitles to your video using the FFMPEGAPI.net service. This example assumes you have an API key for authentication.
curl -X POST https://ffmpegapi.net/api/add_subtitles \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-d '{"video_url":"https://example.com/video.mp4", "subtitle_url":"https://example.com/subtitles.ass"}'Using Python for Subtitles Integration
If you prefer using Python, you can easily make a request to the Add Subtitles endpoint using the requests library. This approach is particularly useful for automation in content pipelines.
import requests
url = 'https://ffmpegapi.net/api/add_subtitles'
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer YOUR_API_KEY'
}
data = {
'video_url': 'https://example.com/video.mp4',
'subtitle_url': 'https://example.com/subtitles.ass'
}
response = requests.post(url, json=data, headers=headers)
print(response.json())Incorporating subtitles into your video content has never been easier with FFMPEGAPI.net. This hosted API allows developers to save time and focus on building innovative applications without the overhead of managing FFmpeg infrastructure. By using the Add Subtitles endpoint, you can enhance your media content effortlessly, making it accessible to a wider audience. Start using FFMPEGAPI.net today for all your video processing needs!