Watermark Image

POST/api/v1/tools/watermark-image2 credits per callwatermarkimagebrandcopyrightstampprotect

Downloads an image from a public URL and draws a text watermark over it. Position and opacity are configurable, so the same call covers a discreet corner credit and a full diagonal proof stamp. Runs on the same code path as the browser tool.

receipt_long

Why 2 credits?

One download plus a pure-CPU raster pass - cheap, but it moves bytes.

Any HTTP client works. Replace the key with one from your dashboard.

bash

curl -X POST https://toolkitbackend-j69m.onrender.com/api/v1/tools/watermark-image \
  -H "Authorization: Bearer tb_live_<your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "fileUrl": "https://example.com/photo.jpg",
  "text": "PROOF",
  "opacity": 0.3,
  "position": "center"
}'

Input

Field	Type	Required	Default	Description
`fileUrl`	string	required	-	Publicly reachable URL of a PNG, JPEG or WebP image.
`text`	string	required	-	Watermark text to draw.
`opacity`	number	optional	0.35	0.05 to 1. Lower is more discreet.
`position`	string	optional	bottom-right	center, top-left, top-right, bottom-left, bottom-right or tile.

Output

Field	Type	Description
`fileBase64`	string	Watermarked image, base64-encoded, without a data URI prefix.
`mimeType`	string	Output image MIME type.
`fileName`	string	Suggested download name.
`sizeBytes`	integer	Size of the decoded image.

Try it

Sends a real POST /api/v1/tools/watermark-image from your browser and charges 2 credits to your account.