How many images can I watermark at once?

About 100 images per browser batch, 25 MB each. Each watermark API call uses one background image URL.

Can I use text instead of a logo?

Yes. Use Add Watermark Text on Image (POST /add-watermark-text-on-image). The example on this page is the logo overlay endpoint.

Is there a watermark SDK?

Picnie does not ship an official SDK. Send an HTTP POST with your API key in the Authorization header.

Where is the output stored?

Each REST call sends one public image URL. The response includes a result URL. Picnie does not write files into your S3, R2 or GCS bucket.

Add Watermark Image

Watermark images with a REST API

Picnie overlays a logo with Add Watermark Image, or text with Add Watermark Text on Image. Each call takes one background image URL. Batch Watermark in the browser stamps about 100 files with the same logo or text settings.

Get an API key Developer overview API reference

Add Watermark Image

POST /add-watermark-image

Authorization header with your API key
Formats: JPG, PNG, GIF and WEBP in Batch Watermark.
Limit: Batch Watermark accepts about 100 images per run, 25 MB each. Folder and ZIP uploads are not supported as input. Text watermarks use POST /add-watermark-text-on-image.

Endpoint docs API overview Batch Watermark

curl -X POST https://picnie.com/api/v1/add-watermark-image \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": 1,
    "background_image_url": "https://picnie.com/data/raw_images/demo_bg1.jpg",
    "front_image_url": "https://picnie.com/data/raw_images/creativity.png",
    "position": "br",
    "image_max_width": "800",
    "image_max_height": "800"
  }'

Other operations

Questions

REST, no SDK

Call the endpoint from any HTTP client.

Create an API key, then use the reference and Postman collection.

Get an API key API reference