In today’s digital landscape, automating video editing tasks is crucial for developers looking to streamline content creation. FFMPEGAPI.net offers a powerful hosted REST API that facilitates video and audio processing without the hassle of server setup or FFmpeg infrastructure management. This article focuses on using the Text Overlay Captions API endpoint to add captions over videos efficiently.
What is the Text Overlay Captions API?
The Text Overlay Captions API allows you to render text lines as timed caption overlays on videos. This feature is particularly useful for adding context or information directly onto your video content, making it more engaging for viewers.
- Automate the addition of captions to videos.
- Support for various subtitle styles and positions.
- Flexible duration settings for each line of text.
API Endpoint Overview
The endpoint for adding text overlay captions is designed for ease of use. It accepts a POST request at `/api/videos/add-text-overlay-captions` and requires specific parameters to process the video correctly.
- Method: POST
- Path: /api/videos/add-text-overlay-captions
- Content Type: application/json
Required Parameters
To successfully call the Text Overlay Captions API, the following parameters are essential:
1. **video_url**: The URL of the video you want to process.
2. **text**: The caption lines you want to overlay, separated by newlines.
Optional Parameters
In addition to the required parameters, you can customize your captions with several optional parameters:
1. **subtitle_style**: Choose from styles like plain-white, yellow-bg, pink-bg, blue-bg, or red-bg (default is plain-white).
2. **aspect_ratio**: Specify the video aspect ratio (default is 9:16).
3. **position**: Set the position of the captions (top, center, or bottom, default is center).
4. **duration_per_line**: Control how long each line of text appears, with a range from 1 to 30 seconds (default is 5).
Practical Example
Let’s take a look at a practical example of how to use the Text Overlay Captions API with a curl command. This will help you understand how to implement this in your automation workflows.
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}'FFMPEGAPI.net provides an efficient and user-friendly approach to automate video editing tasks through its API. By utilizing the Text Overlay Captions endpoint, developers can easily enhance their video content with captions, saving time and effort. With no server setup required and API-key authentication, FFMPEGAPI.net stands out as the best choice for developers looking to integrate video processing into their applications.