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

watermarked.mp4: 30 s at 1920x1080, with logo.png scaled to 120 px wide at 85% opacity, bottom right.Input: launch.mp4watermarked.mp4 (15.8 MB)logo.png

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.

terminalTry it
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"]
  }'
request.mjsTry it
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();
response.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

Ways to watermark a video
OptionPriceLimitsWhat you run
ffmpeg on your own machineFree; LGPL 2.1 or later, or GPL 2 or later with GPL libraries such as libx264Your CPU, disk and bandwidthffmpeg 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 payloadThe layer, S3 in and out, retries
FFmpeg Micro1 token per 10 s of input, 500 tokens for $5; this 30 s input: 3 tokens, $0.03100 MB input on the free plan, 1,024 MB on Starter and ProAPI calls
ReelSDK$0.02 per compute minute; about two thirds of a cent for this 30 s clip500 MB per file, 1 GB per job, 10 minutes of run timeOne 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

  1. 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.mp4 first: up to 100 MiB per upload, kept 7 days, and larger files go up as a multipart upload.

  2. Send the arguments

    The logo is the second input. scale=120:-1 sizes it, format=rgba,colorchannelmixer=aa=0.85 sets 85% opacity, and overlay=W-w-40:H-h-40 places it 40 px from the bottom-right corner. -c:a copy keeps the sound as it was.

  3. 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=0 with a webhook_url and fetch GET /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.

Ready to build?

Ship video from your app today

Your first $0.50 is free, and one key covers every endpoint.

Moonlit lake with a lit cabin under the mountains