Image watermark

POST /api/image-watermark

Add a text watermark to an image: configurable text, font size, opacity, rotation, position, and colour. Useful for asset attribution and copy tracking.

Stamps a text watermark across an image. Common use cases: asset attribution, "DRAFT" / "CONFIDENTIAL" overlays, copy-tracking IDs, sample-image watermarks before paid download. Tunable: text, font size, opacity, rotation, anchor position, colour. Multiple repeats across the image are supported via `tile: true`.

Inputs

Name	Type	Default	Description
image*	file	—	Base image (PNG / JPEG / WebP).
watermark*	file	—	Watermark image (PNG / JPEG / WebP). Transparent PNG strongly recommended.
gravity	enum (north \| south \| east \| west \| northeast \| northwest \| southeast \| southwest \| center)	"southeast"	Which edge / corner the watermark is anchored to.
opacity	number (0…100)	60	Blend opacity 0–100% (100 = fully opaque, 0 = invisible).
scale	number (0…100)	0	When > 0, scale the watermark so its width is this percentage of the base image's smaller side. 0 keeps the watermark at its native size.
offsetX	number (-8192…8192)	0	Pixel offset from the gravity anchor on the X axis.
offsetY	number (-8192…8192)	0	Pixel offset from the gravity anchor on the Y axis.
format	enum (png \| jpeg \| webp)	—	Output format. Defaults to the base image's format.

Response

Modes: binary, base64-json. Cache: yes (24h TTL).