Adding Text Overlay Captions to Videos with FFMPEGAPI.net

What is FFMPEGAPI.net?

FFMPEGAPI.net is a hosted REST API that simplifies video and audio processing using the powerful FFmpeg library. It eliminates the need for server setup or FFmpeg infrastructure management, allowing developers to focus on building their applications.

With API-key authentication, FFMPEGAPI.net is designed to support a variety of workflows including automation, SaaS applications, content pipelines, and AI agents.

Using the Text Overlay Captions Endpoint

The Text Overlay Captions endpoint allows you to render user-provided text lines as timed caption overlays on your videos. This feature is particularly useful for creating engaging content that caters to a wider audience.

To use this endpoint, you need to send a POST request to the following path: /api/videos/add-text-overlay-captions.

The parameters required for this request include the video URL and the text you want to overlay, along with optional styling and positioning parameters.

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}'

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())

Parameters Explained

Here’s a breakdown of the parameters you can utilize to customize your captions:

1. **video_url (string)**: The URL of the video you want to overlay captions on.

2. **text (string)**: The caption lines, separated by newlines.

3. **subtitle_style (string)**: You can choose from styles like plain-white, yellow-bg, pink-bg, blue-bg, or red-bg, with a default of plain-white.

4. **aspect_ratio (string)**: Supported values are 16:9, 9:16, 4:3, or 3:4, with a default of 9:16.