Overlay Watermark

Overlay a static image watermark onto every frame of the video.

When to use

• Brand videos with a company logo before distribution.
• Protect content with a semi-transparent watermark.
• Add a visual identifier to user-generated content.

Inputs & outputs

Input modality	Video file (URL)
Output modality	Video file (GCS URL)
Max input duration	30 min
Max input size	5 GB

Parameters

Param	Required	Description
watermark_url	yes	GCS or HTTPS URL of the watermark image (PNG recommended for transparency)
position	no	Corner or center — tl, tr, bl, br, center. Default: br
opacity	no	Opacity from 0 (transparent) to 1 (opaque). Default: 0.8

Examples

Bottom-right logo at 80% opacity

{
  "type": "video.watermark",
  "input": { "video_url": "gs://infery-prod-media/example/input.mp4" },
  "params": {
    "watermark_url": "gs://infery-prod-media/brand/logo.png",
    "position": "br",
    "opacity": 0.8
  }
}

Subtle center watermark for draft preview

{
  "type": "video.watermark",
  "input": { "video_url": "gs://infery-prod-media/example/draft.mp4" },
  "params": {
    "watermark_url": "gs://infery-prod-media/brand/draft-overlay.png",
    "position": "center",
    "opacity": 0.3
  }
}

Related capabilities

• video.crop — crop to frame before adding watermark
• video.transcode — compress watermarked output for delivery
• video.pipeline — combine watermark with other operations in one step

{
  "watermark_url": "gs://b/logo.png",
  "position": "br",
  "opacity": 0.8
}