Watermark Image
Pricing
$2.60 / 1,000 image watermarkeds
Watermark Image
Add custom text or logo watermarks to images in bulk using Sharp. Control position, opacity, font, and size with ease.
Watermark Image
Pricing
$2.60 / 1,000 image watermarkeds
Add custom text or logo watermarks to images in bulk using Sharp. Control position, opacity, font, and size with ease.
List of images to watermark. Each object must have either a "url" (string) or "kvStoreKey" (string). Min: 1, Max: 1000.
[ { "url": "https://upload.wikimedia.org/wikipedia/commons/thumb/4/47/PNG_transparency_demonstration_1.png/280px-PNG_transparency_demonstration_1.png" }]Type of watermark: "text" overlays text, "image" composites a logo/image.
Text to overlay. Max 200 characters. Only used when watermarkType is "text".
Font size in pixels. Min: 8, Max: 500.
Font color as hex string (e.g. "#FFFFFF") or CSS color name.
Font family: sans-serif, serif, or monospace.
URL to a TTF/OTF font file. Downloaded and used for text rendering. Falls back to fontFamily if invalid.
Add a dark stroke/outline around text for readability on any background.
Stroke color as hex string (e.g. "#000000").
Stroke width in pixels. Min: 0, Max: 10.
URL of the watermark image/logo. PNG with transparency recommended. Required when watermarkType is "image".
KV Store key for watermark image (alternative to watermarkImageUrl).
Scale of watermark image relative to source image width. 0.1 = 10%, 1.0 = 100%. Min: 0.01, Max: 1.0.
Where to place the watermark on the image.
Watermark opacity. 0.01 = nearly transparent, 1.0 = fully opaque. Min: 0.01, Max: 1.0.
Rotation angle in degrees. Use -45 for diagonal watermarks. Min: -360, Max: 360.
Padding from image edges in pixels. Min: 0, Max: 500.
Repeat watermark across entire image in a grid pattern. Overrides position.
Spacing between tiled watermarks in pixels. Min: 10, Max: 1000. Only used when tiled is true.
Output image format: png, jpeg, or webp.
Output quality for JPEG/WebP output. 1–100. Ignored for PNG.
Prefix for output filenames in KV Store.
Maximum output width in pixels. Images larger than this are resized (aspect ratio preserved). Leave empty for no resize.
Maximum output height in pixels. Leave empty for no resize.
Maximum concurrent image processing operations. Min: 1, Max: 20.