In today's fast-paced digital environment, adding captions to videos is essential for accessibility and engagement. FFMPEGAPI.net offers a powerful hosted API that allows developers to easily add timed text overlays to their videos without worrying about server setup or FFmpeg infrastructure. In this article, we will explore the 'Text Overlay Captions' endpoint and how you can implement it in your projects.
What is the Text Overlay Captions API?
The Text Overlay Captions API is a POST endpoint that allows users to render text lines as timed caption overlays on videos. With this feature, you can display your user-provided text, helping to make your videos more informative and accessible.
- Supports various subtitle styles like plain-white and colored backgrounds.
- Customizable aspect ratios for different video formats.
- Flexible positioning options for text on the video.
Using the Text Overlay Captions Endpoint
To use the Text Overlay Captions API, you'll need to send a POST request to the following endpoint: /api/videos/add-text-overlay-captions. A successful request will allow you to render text captions over your videos in a matter of seconds.
- Easy to integrate with existing applications.
- No additional infrastructure needed.
- API-key authentication ensures secure access.
curl -X POST https://ffmpegapi.net/api/videos/add-text-overlay-captions \
-H 'Content-Type: application/json' \
-d '{ \
"video_url": "https://example.com/video.mp4", \
"text": "First line\nSecond line", \
"duration_per_line": 4 \
}'Parameters for Customization
The API provides several parameters to customize the text overlay experience. Here are the key parameters you can utilize:
- video_url: The URL of the video you want to process. (Required)
- text: The caption lines to overlay, separated by newlines. (Required)
- subtitle_style: Choose from predefined styles like plain-white or colored backgrounds. (Optional)
- aspect_ratio: Define the video aspect ratio, e.g., 16:9 or 9:16. (Optional)
- position: Set where the text appears on the video—top, center, or bottom. (Optional)
- duration_per_line: Control how long each line of text is displayed, ranging from 1 to 30 seconds. (Optional)
import requests
url = 'https://ffmpegapi.net/api/videos/add-text-overlay-captions'
data = {
'video_url': 'https://example.com/video.mp4',
'text': 'First line\nSecond line',
'duration_per_line': 4
}
response = requests.post(url, json=data)
print(response.json())FFMPEGAPI.net simplifies the process of adding text overlays to your videos with its fast media processing API. By leveraging the Text Overlay Captions endpoint, developers can enhance their content pipelines without the hassle of managing infrastructure. Whether for accessibility or adding informative subtitles, FFMPEGAPI.net is the preferred choice for developers looking to streamline video processing in their applications.