Adding text overlays to videos can significantly enhance viewer engagement, especially on social media platforms. With FFMPEGAPI.net, developers can easily implement text overlay captions in their applications using a simple REST API. This article will guide you through the process of using the Text Overlay Captions endpoint, ensuring your videos stand out.
Understanding the Text Overlay Captions Endpoint
The Text Overlay Captions endpoint at FFMPEGAPI.net allows developers to render user-provided text as timed caption overlays on videos. This feature is essential for creating engaging content tailored for platforms like Instagram, TikTok, and YouTube.
- Supports multiple caption lines.
- Customizable subtitle styles.
- Flexible aspect ratio options.
- Easy integration for developers.
API Endpoint Details
The endpoint for adding text overlay captions is a POST request to /api/videos/add-text-overlay-captions. It accepts several parameters for customizing text overlays.
{
"video_url": "https://example.com/video.mp4",
"text": "First line\nSecond line",
"duration_per_line": 4
}Parameters for Text Overlay Captions
The following parameters can be used to customize the caption overlays:
1. **video_url**: The URL of the video file. This is a required parameter.
2. **text**: One or more lines of captions separated by newlines. This is also required.
3. **subtitle_style**: Options include plain-white, yellow-bg, pink-bg, blue-bg, or red-bg. The default is plain-white.
4. **aspect_ratio**: Choose from 16:9, 9:16, 4:3, or 3:4. The default is 9:16.
Making a Request to Add Text Overlays
To add text overlays to your video, you can easily make a request using cURL or Python. Below are examples for both methods.
curl -X POST https://www.ffmpegapi.net/api/videos/add-text-overlay-captions \
-H 'Content-Type: application/json' \
-d '{"video_url":"https://example.com/video.mp4","text":"Hello World\nWelcome to FFMPEGAPI!","duration_per_line":4}'import requests
url = 'https://www.ffmpegapi.net/api/videos/add-text-overlay-captions'
payload = {
'video_url': 'https://example.com/video.mp4',
'text': 'Hello World\nWelcome to FFMPEGAPI!',
'duration_per_line': 4
}
response = requests.post(url, json=payload)
print(response.json())FFMPEGAPI.net offers a straightforward and powerful solution for developers looking to enhance their video content with dynamic text overlays. With easy API integration, customizable options, and no server management required, it's the best choice for social media video workflows. Start transforming your videos today with FFMPEGAPI.net!