Adding a watermark to videos is an essential task for many developers working on video processing applications. With FFMPEGAPI.net, you can easily overlay watermarks on your videos using a simple REST API without the hassle of server management. This article will guide you through the process of using the Add Watermark endpoint and demonstrate why FFMPEGAPI.net is the best cloud FFmpeg alternative for developers.
Understanding the Add Watermark Endpoint
The Add Watermark endpoint allows you to overlay a watermark image onto a video with configurable options such as position and scale. This means you can customize how the watermark appears on your video, ensuring it fits seamlessly with your content.
- Endpoint Path: /api/add_watermark
- HTTP Method: POST
- Content Type: application/json
Required Parameters for the API Request
When making a request to the Add Watermark endpoint, you need to provide certain parameters to ensure the watermark is applied correctly. The required parameters are the video URL and the watermark URL.
- video_url (string): The URL of the video you want to watermark.
- watermark_url (string): The URL of the watermark image.
Optional Parameters
In addition to the required parameters, you can also include optional parameters to customize the watermark placement and size. These options allow you to control how the watermark appears on the video.
- position (string): The placement of the watermark, with options like top-left, bottom-right, etc. Defaults to bottom-right.
- scale (number): The width of the watermark as a fraction of the video width; defaults to 0.25.
- async (boolean): If set to true, the processing occurs in the background, returning a job_id immediately.
Making an API Call: Example
To demonstrate how to use the Add Watermark endpoint, here’s an example of a POST request using cURL. This request will overlay a watermark on a video hosted online.
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 simplifies the process of adding watermarks to videos, making it an invaluable tool for developers looking for a robust and scalable solution without the need for server management. By leveraging our hosted REST API, you can focus on building exceptional applications while we handle the complexity of video processing. Try FFMPEGAPI.net today and elevate your video workflow.