apyhub
FILE MANIPULATION

Apply Invisible Text Watermark on Image API

What it does

Invisible Text Watermark adds a text watermark to a source image and returns the processed image as a binary file. Send one image file and the watermark text you want embedded; get back an image with the watermark applied.

Use it when you need to mark campaign assets, internal previews, or distributed images without adding visible branding. The endpoint accepts the image in the request body as file, plus a text value up to 1000 characters. That makes it useful for tracking ownership or source across shared files while keeping the mark out of sight.

Because the response is binary, you can pass the output directly into storage, delivery, or further image workflows without extra parsing. If you already handle image uploads and downloads in your application, this fits into that flow with minimal glue code.

Invisible Text Watermark is a file-processing utility for teams that need lightweight image marking without changing the visual layout of the asset.

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

QUICKSTART

GUIDE

Quickstart

Upload an image file and pass the watermark text as a query parameter.

curl -X POST "https://api.eu.apyhub.com/dosvak/embed-invisible-text-watermark?text=campaign-id-123" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/image.jpg"

What you'll get back

Returns a binary file (string with format: binary), which is the watermarked image.

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

About this endpoint

What it does

Embeds an invisible text watermark into a source image. It takes an uploaded image file and a watermark text string, and returns the processed image as binary data.

Query Parameter(s)

AttributeTypeMandatoryDescription
textStringYesWatermark text to embed. Must be between 1 and 1000 characters.

Request Body

ParameterTypeMandatoryDescription
fileStringYesSource image file uploaded as binary. Maximum size: 20 MB.

Response

Returns a binary response containing the image with the invisible text watermark embedded.

ParameterTypeMandatoryDescription
binaryStringYesThe processed image file returned as binary data.

Query parameters

Name
Type
Description
textREQUIRED
string

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.