Send the video and your logo URL to POST /v1/ffmpeg with an overlay filter, and ReelSDK returns the stamped MP4: 30 seconds of 1080p costs about two thirds of a cent at $0.02 per compute minute.
Video watermark API
Yes: in one filtergraph on ReelSDK, the PNG is scaled to 120 px wide, set to 85% opacity and placed 40 px from the bottom-right corner, while the sound passes through untouched.
Use casesUpdated
The request
POST /v1/ffmpeg
Stamp a PNG logo on every frame at any position and opacity with one ffmpeg call, about two thirds of a cent per 30 s clip.
curl "https://api.reelsdk.com/v1/ffmpeg?wait=60" \
-H "Authorization: Bearer $REELSDK_KEY" \
--json '{
"inputs": {
"launch.mp4": "https://api.reelsdk.com/f/lib/in/use-cases/launch.mp4",
"logo.png": "https://api.reelsdk.com/f/lib/in/use-cases/logo.png"
},
"args": [
"-i", "launch.mp4", "-i", "logo.png", "-filter_complex",
"[1:v]scale=120:-1,format=rgba,colorchannelmixer=aa=0.85[logo];[0:v][logo]overlay=W-w-40:H-h-40",
"-c:v", "libx264", "-crf", "20", "-preset", "veryfast", "-c:a", "copy",
"-movflags", "+faststart", "watermarked.mp4"
],
"outputs": ["watermarked.mp4"]
}'const res = await fetch("https://api.reelsdk.com/v1/ffmpeg?wait=60", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.REELSDK_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"inputs": {
"launch.mp4": "https://api.reelsdk.com/f/lib/in/use-cases/launch.mp4",
"logo.png": "https://api.reelsdk.com/f/lib/in/use-cases/logo.png"
},
"args": [
"-i", "launch.mp4", "-i", "logo.png", "-filter_complex",
"[1:v]scale=120:-1,format=rgba,colorchannelmixer=aa=0.85[logo];[0:v][logo]overlay=W-w-40:H-h-40",
"-c:v", "libx264", "-crf", "20", "-preset", "veryfast", "-c:a", "copy",
"-movflags", "+faststart", "watermarked.mp4"
],
"outputs": ["watermarked.mp4"]
}),
});
const { job } = await res.json();{
"job": {
"id": "job_o3iffsmrol2ztj6hdol2",
"op": "ffmpeg",
"status": "succeeded",
"stage": null,
"created_at": "2026-11-07T01:20:08.861Z",
"finished_at": "2026-11-07T01:20:31.929Z",
"outputs": {
"watermarked.mp4": "https://api.reelsdk.com/f/out/job_o3iffsmrol2ztj6hdol2/watermarked.mp4?s=..."
},
"result": null,
"duration_s": 30,
"error": null,
"usage": {
"output_seconds": 30,
"audio_seconds": 0,
"tts_characters": 0,
"images": 0
},
"poll_url": "https://api.reelsdk.com/v1/jobs/job_o3iffsmrol2ztj6hdol2"
}
}How the overlay filter works
The job takes two inputs: launch.mp4 as [0:v] and logo.png as [1:v]. Inside -filter_complex, the first chain takes the 256x256 PNG and runs scale=120:-1 to resize it to 120 px wide, then format=rgba and colorchannelmixer=aa=0.85 to set 85% opacity and label it [logo]. The second chain runs [0:v][logo]overlay=W-w-40:H-h-40, which places the logo 40 px from the bottom-right corner of the 1920x1080 video.
Adding a watermark changes the pixels on every frame, so the video stream has to be re-encoded. This run uses -c:v libx264, -crf 20 and -preset veryfast, plus -movflags +faststart on watermarked.mp4. The audio stream doesn't change, so -c:a copy copies the AAC track straight through without re-encoding.
At a glance
Ways to watermark a video
| Option | Price | Limits | What you run |
|---|---|---|---|
| ffmpeg on your own machine | Free; LGPL 2.1 or later, or GPL 2 or later with GPL libraries such as libx264 | Your CPU, disk and bandwidth | ffmpeg builds, a job queue, storage |
| AWS Lambda with an ffmpeg layer | $0.0000166667 per GB-second plus $0.20 per 1M requests (x86, US East) | 900 s per run, 10,240 MB memory and /tmp, 250 MB of code and layers, 6 MB sync payload | The layer, S3 in and out, retries |
| FFmpeg Micro | 1 token per 10 s of input, 500 tokens for $5; this 30 s input: 3 tokens, $0.03 | 100 MB input on the free plan, 1,024 MB on Starter and Pro | API calls |
| ReelSDK | $0.02 per compute minute; about two thirds of a cent for this 30 s clip | 500 MB per file, 1 GB per job, 10 minutes of run time | One HTTP call |
Sources: FFmpeg license and legal, AWS Lambda quotas, AWS Lambda pricing, FFmpeg Micro pricing, checked November 2026.
Text watermarks and corner positions
If you want text instead of a PNG, swap overlay for the drawtext filter and pass a fontfile from /usr/share/fonts/reelsdk in args. The ffmpeg endpoint docs cover how args are passed directly to ffmpeg without a shell. ReelSDK bundles 10 fonts covering Latin, Japanese, Chinese, and Korean: Anton, Bebas Neue, Montserrat Black and ExtraBold, Poppins Bold, ExtraBold and Black, and Noto Sans JP, SC and KR Bold.
Moving a logo to another corner just means changing the overlay expression. W and H are the main video dimensions, and w and h are the scaled overlay dimensions:
- Top-left (40 px margin):
overlay=40:40 - Bottom-right (40 px margin):
overlay=W-w-40:H-h-40
Cost and job limits
Fetching the inputs, running ffmpeg and storing watermarked.mp4 billed about 19 seconds of compute, and machine start-up isn't billed. At $0.02 per compute minute that comes to about two thirds of a cent. We bill per second with a 1 s minimum, failed jobs cost $0, and you get $0.50 of free credit at sign-up on our pricing page.
For the same 30 s input, FFmpeg Micro charges 1 token per 10 seconds of input, which is 3 tokens or $0.03 at the top-up rate of 500 tokens for $5.
What it costs
What this job cost
- Compute: fetching the inputs, running ffmpeg and storing the file
- 18.9 s
- Rate
- $0.02 per compute minute
- Charged
- $0.0063
Billed per second with a 1 s minimum. Machine start-up is not billed, and failed jobs cost $0.
Limits
What one request takes
- Input files
- 500 MB each, 1 GB per job
- Job run time
- Up to 10 minutes
- Fonts for text marks
- 10 bundled, Latin, Japanese, Chinese and Korean
- Waiting for a result
- 60 s by default, up to 300 s
- Output retention
- 7 days
How it works
From request to file
Host the input
Any public http or https URL on the default port works, as long as it has no username or password in it; ReelSDK downloads it before ffmpeg starts. A local file goes up with
POST /v1/uploads?filename=clip.mp4first: up to 100 MiB per upload, kept 7 days, and larger files go up as a multipart upload.Send the arguments
The logo is the second input.
scale=120:-1sizes it,format=rgba,colorchannelmixer=aa=0.85sets 85% opacity, andoverlay=W-w-40:H-h-40places it 40 px from the bottom-right corner.-c:a copykeeps the sound as it was.Download the result
Every file is listed under
job.outputs, and the links work for 7 days, so copy what you keep. For long jobs, send?wait=0with awebhook_urland fetchGET /v1/jobs/{id}when the webhook arrives.
FAQ
Questions, answered
How do I adjust video quality and output file size?
Since the video stream is re-encoded, you control quality and file size through your codec flags in args. This run used -c:v libx264 -crf 20 -preset veryfast and turned an 18.6 MB 1080p input into a 15.8 MB output. You can change the -crf value or -preset in args, and -c:a copy keeps the original audio untouched.
Can I add multiple watermarks or render several versions in one job?
Yes, a single job to POST /v1/ffmpeg accepts up to 50 inputs and up to 20 outputs. You can pass several PNG files in inputs and chain multiple overlay filters in -filter_complex, or write out multiple MP4 files listed in outputs from one run. Each output file is kept for 7 days.
How does this compare to AWS Lambda or FFmpeg Micro?
FFmpeg Micro charges 1 token per 10 seconds of input ($0.03 for this 30 s clip at the 500 tokens for $5 top-up rate) and caps files at 100 MB on the free plan or 1,024 MB on Starter and Pro. AWS Lambda charges $0.0000166667 per GB-second (x86, US East) plus $0.20 per 1M requests. On ReelSDK this job cost about two thirds of a cent.
- Add a watermark or logo to a video with ffmpegPut a PNG logo in a corner with overlay: scale it, make it semi-transparent, keep it off the edge, or show it only for the first seconds.
- Burn subtitlesHard-code an SRT, ASS or VTT file into a video with one ffmpeg call and 10 bundled fonts, for well under a cent a clip.
- Vertical videoTurn 16:9 footage into a 1080x1920 vertical video with a blurred fill in one ffmpeg call, about a quarter cent per 30 s clip.
- Merge videosJoin clips into one MP4 by URL with the concat filter or demuxer, up to 50 inputs, for well under a cent a merge.
- Resize videoRender 9:16, 1:1, 4:5 and 16:9 copies of one video in a single ffmpeg call, about 2 cents for all 4 from a 30 s clip.
- FFmpeg API reference: POST /v1/ffmpegPOST /v1/ffmpeg runs ffmpeg 8.1 with your own arguments: up to 50 inputs of 500 MB, 20 outputs and 600 s per command, with tested recipes for GIFs, thumbnails and subtitles.
- What is a rendering API?What a rendering API does: send a JSON or code description, get an MP4 back. What you send, who renders it, and what it costs per minute.
Sources, checked November 2026
Ready to build?
Ship video from your app today
Your first $0.50 is free, and one key covers every endpoint.
