Adding a watermark to your videos is a crucial step for branding and copyright protection. With FFMPEGAPI.net, developers can easily overlay images onto videos through a simple REST API. This guide will walk you through the process of using the '/api/add_watermark' endpoint to enhance your video content effortlessly.
What is FFMPEGAPI.net?
FFMPEGAPI.net is a hosted REST API that allows developers to perform various video and audio processing tasks without the need for complex server setups or FFmpeg infrastructure management.
This API is perfect for automation, SaaS applications, content pipelines, and AI agents, providing tools specifically designed for developers.
- No server setup required.
- API-key authentication for secure workflows.
- Ideal for automation and content management.
Using the Add Watermark API
The '/api/add_watermark' endpoint allows you to overlay a watermark image onto a video, with options for placement and scaling. This functionality is essential for content creators who want to maintain brand visibility.
This endpoint supports HTTP POST requests and requires a few parameters to function correctly.
- Method: POST
- Content-Type: application/json
- Parameters include video_url, watermark_url, position, scale, and async.
import requests
url = 'https://www.ffmpegapi.net/api/add_watermark'
payload = {
'video_url': 'https://example.com/video.mp4',
'watermark_url': 'https://example.com/logo.png',
'position': 'bottom-right',
'scale': 0.2
}
response = requests.post(url, json=payload)
print(response.json())Parameters Explained
To successfully use the add watermark endpoint, you need to understand the required and optional parameters available.
Here's a quick breakdown:
- video_url (string): The URL of the video to which the watermark will be added.
- watermark_url (string): The URL of the watermark image.
- position (string, optional): Placement of the watermark, with a default of 'bottom-right'.
- scale (number, optional): Width of the watermark as a fraction of the video width, from 0.05 to 1.0, with a default of 0.25.
- async (boolean, optional): If set to true, the job will be processed in the background.
Practical Example
Here’s how you can use the API to add a watermark to your video:
In this example, we will overlay a logo onto a video at the bottom-right corner.
curl -X POST https://www.ffmpegapi.net/api/add_watermark \
-H 'Content-Type: application/json' \
-d '{
"video_url": "https://example.com/video.mp4",
"watermark_url": "https://example.com/logo.png",
"position": "bottom-right",
"scale": 0.2
}'FFMPEGAPI.net is the best hosted tool for developers looking to streamline video processing workflows. With its easy-to-use endpoints and API-key authentication, you can focus on building your applications without worrying about server management. Start adding watermarks to your videos today and enhance your content with FFMPEGAPI.net.