Overlay a logo/watermark on a video. Scales the watermark image relative to video width and positions it at the chosen corner or center. Supports opacity control. Example: {"url": "https://cdn.example.com/video.mp4", "watermark_url": "https://cdn.example.com/logo.png", "position": "bottom_right"}
Overlay a logo/watermark on a video.
Scales the watermark image relative to video width and positions it at the chosen corner or center. Supports opacity control.
Example: {"url": "https://cdn.example.com/video.mp4", "watermark_url": "https://cdn.example.com/logo.png", "position": "bottom_right"}
{
"url": "https://cdn.example.com/video.mp4",
"scale": 0.15,
"margin": 10,
"opacity": 0.8,
"position": "bottom_right",
"watermark_url": "https://cdn.example.com/logo.png"
}
{
"job_id": "f595b9ad-1e15-4452-b7c2-8f8ff09c0a34",
"status": "pending",
"message": "Job created. Poll status_url for progress.",
"job_type": "caption",
"result_url": "https://eranol.com/api/v1/ffmpeg/result/f595b9ad-1e15-4452-b7c2-8f8ff09c0a34",
"status_url": "https://eranol.com/api/v1/ffmpeg/status/f595b9ad-1e15-4452-b7c2-8f8ff09c0a34"
}
Send your requests to the following URL using the specified HTTP method.
POST https://eranol.com/api/v1/ffmpeg/video/watermarkInclude the following headers with every request. Your API key is required for authentication.
Send the following JSON payload in the request body. Adjust the values to match your use case.
{
"url": "https://cdn.example.com/video.mp4",
"scale": 0.15,
"margin": 10,
"opacity": 0.8,
"position": "bottom_right",
"watermark_url": "https://cdn.example.com/logo.png"
}All available options for this endpoint. Required parameters are marked accordingly.
| Parameter | Type | Default | Description |
|---|---|---|---|
| url | string | required | Video file URL |
| watermark_url | string | required | Watermark image URL (png recommended for transparency) |
| position | string | bottom-right | Position: top-left, top-right, bottom-left, bottom-right, or center |
| scale | float | 0.15 | Watermark size relative to video width (0.01–1.0) |
| opacity | float | 0.8 | Watermark opacity (0.0–1.0) |
Use the following cURL command to make a request to this API endpoint. Replace YOUR_API_KEY with your actual API key from the dashboard.
curl -X POST "https://eranol.com/api/v1/ffmpeg/video/watermark" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://cdn.example.com/video.mp4","scale":0.15,"margin":10,"opacity":0.8,"position":"bottom_right","watermark_url":"https://cdn.example.com/logo.png"}'Below is an example of a successful JSON response from this endpoint.
{
"job_id": "f595b9ad-1e15-4452-b7c2-8f8ff09c0a34",
"status": "pending",
"message": "Job created. Poll status_url for progress.",
"job_type": "caption",
"result_url": "https://eranol.com/api/v1/ffmpeg/result/f595b9ad-1e15-4452-b7c2-8f8ff09c0a34",
"status_url": "https://eranol.com/api/v1/ffmpeg/status/f595b9ad-1e15-4452-b7c2-8f8ff09c0a34"
}A successful request will return one of the following HTTP status codes.