apyhub
▣ FILE MANIPULATION

Apply Invisible Watermark on Image API

What it does

Invisible Watermark lets you embed a hidden watermark into an image. Send a source image and a small logo or watermark image, and get back a binary image file with the watermark applied.

Use the max_size query parameter to control the watermark size, from 16 to 160, with a default of 64. The endpoint accepts source images up to 20 MB, which makes it suitable for marking product photos, editorial assets, and preview images before distribution.

This is a good fit when you want to identify ownership or trace the source of images without placing a visible mark on the asset itself. You can use it to tag internal drafts, protect shared previews, or prepare branded media for delivery while keeping the main image clean.

The response is the processed image as binary data, so it can be stored, forwarded, or passed into another file workflow without extra parsing.

POST
Embed an invisible image watermark
https://api.eu.apyhub.com/dosvak/embed-invisible-image-watermark

QUICKSTART

GUIDE

Quickstart

Upload a source image and a small watermark image to generate an invisible watermarked result.

curl -X POST "https://api.eu.apyhub.com/dosvak/embed-invisible-image-watermark" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/source-image.png" \
  -F "watermark=@/path/to/watermark.png"

What you'll get back

Returns a binary file response.

TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.
body*
Source image
Small logo/watermark image

About this endpoint

What it does

Embeds a watermark image into a source image and returns the resulting image as binary data.

Query Parameter(s)

AttributeTypeMandatoryDescription
max_sizeIntegerNoMaximum watermark size in pixels. Default: 64. Minimum: 16. Maximum: 160.

Request Body

ParameterTypeMandatoryDescription
fileStringYesSource image. Binary file. Max 20 MB.
watermarkStringYesSmall logo/watermark image. Binary file.

Response

Returns the processed image as a binary string.

Query parameters

Name
Type
Description
max_sizeOPTIONAL
integer
—
DEFAULT 64

Body

Name
Type
Description
bodyREQUIRED
object
—

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.