How to add a watermark to a video with an API
Branding every export with a logo is a filtergraph in FFmpeg and a design decision about placement and opacity. With an API it is one call with a position and an opacity.
The manual FFmpeg way
Positioning maths and an alpha filter for opacity are easy to get subtly wrong. A typed tool takes a position, a width and an opacity and composes the overlay for you.
ffmpeg -i input.mp4 -i logo.png -filter_complex "[1]format=rgba,colorchannelmixer=aa=0.85[wm];[0][wm]overlay=W-w-20:H-h-20" branded.mp4
Do it with one API call
- 1
Host the video and the logo
Provide public URLs, or upload each and use the returned media URLs.
- 2
Call the watermark tool
Pass the video as "main" and the logo as watermark_url, then set position, width and opacity.
- 3
Download the branded video
Poll the job and download the finished MP4 from the signed output URL.
REST
curl https://kinopipe.com/api/v1/tools/add-watermark-to-video \
-H "Authorization: Bearer kp_live_..." \
-H "Content-Type: application/json" \
-d '{
"inputs": [
{ "id": "main", "url": "https://example.com/input.mp4" },
{ "id": "watermark", "url": "https://example.com/logo.png" }
],
"options": { "position": "bottom-right", "width": 240, "opacity": 0.85 }
}'FAQ
Where can the watermark go?
Choose a corner or centre position; the tool places the logo there with a small margin.
Can I control the size and transparency?
Yes. Set width in pixels and opacity between 0.05 and 1 to make the logo subtle or prominent.