New users get free credits - no credit card required Get started
APIAny.Dev logoAPIAny.Dev

Add Watermark

Apply a text or image watermark to a single image.

POST /api/free/watermark

Use Add Watermark online

Upload, configure, preview and download without an API key.

No sign-in or API key

1. Upload and settings

Use this tool online without an API key. Files are sent only when you run the request.

Source image *
Watermark image
Watermark text
Position
Opacity
Font size
Text color
Complete the required fields to run the tool.POST /api/free-online/watermark

2. Preview and download

Your result will appear here

Preview, size changes and download controls are shown here

Integrate with the API

Only programmatic calls require an API key. Parameters, responses and errors are documented below.

API endpoint
POST /api/free/watermark

Online use is keyless. Programmatic calls to this endpoint require an APIAny key.

How it works
  • Provide watermarkImage for image watermark or text for text watermark.
  • Returns a PNG image response.

Response

A successful request returns a image response with the Content-Type described by this page.

Common errors

400
A file or parameter is missing, invalid or outside the documented limit.
401
The API key is missing, invalid or disabled for programmatic API calls.
429
The online or authenticated shared rate limit has been reached.

Parameters and limits

ParameterRequirementDefaultAccepted values
imageSource imageRequired—file
watermarkImageWatermark imageOptional—file
textWatermark textOptional—text
positionPositionOptionalbottom-righttop-left, top-right, bottom-left, bottom-right, center
opacityOpacityOptional0.5number
fontSizeFont sizeOptional32number
colorText colorOptional#fffffftext

API example

Use this authenticated example in code. The online Playground above intentionally does not request or expose your key.

curl -X POST "https://apiany.ai/api/free/watermark" \
  -H "Authorization: Bearer $API_KEY" \
  -F "image=@input.png" \
  -F "text=APIAny" \
  -F "position=bottom-right" \
  --output watermarked.png

Frequently asked questions

Do I need an API key for Add Watermark?

No key is required in the online Playground. Programmatic requests use Authorization: Bearer or X-API-Key.

What are the limits for Add Watermark?

Online use is limited to 3 requests per minute and 30 per day. Authenticated free accounts receive 5 RPM and paid accounts receive 500 RPM across free APIs.

Which inputs does Add Watermark accept?

Use the required and optional fields in the parameter table. Unsupported formats and out-of-range values are rejected.

What does Add Watermark return?

Successful requests return a image response. Errors use the HTTP status codes listed above.

Source: APIAny free API catalog and live route behavior. Content reviewed 2026-07-17.