# Add a text watermark

Add a text watermark to an image in a corner, in the centre or tiled across it, with adjustable opacity and size.

- Endpoint: `POST https://setget.net/v1/tools/image-watermark` with JSON `{"input": {...}}` (add `"wait": 30` to hold the reply until the job finishes)
- MCP: `run_tool` with `slug` = `image-watermark`
- Page: https://setget.net/tools/image-watermark

## Files in, files out

This is a file tool. Its file inputs take file references, not file contents and not web addresses.

- Get a reference by uploading: `curl -T FILE https://setget.net/drop/` prints a line `ref  <id>/f1`. Or `POST https://setget.net/v1/drops` with `{"files":[{"name","size"}]}`, PUT the bytes to the returned `upload.url` with the listed headers, and use the file's `ref`. Over MCP use the `drop` tool. A file under about 700 KB can also be sent in place as a `data:<type>;base64,<content>` URI.
- Uploads are at most 100 MB per file, are readable by anyone with the link, and expire (one hour by default). Programs are refused.
- The tool runs as a job. The reply is `{"tool", "ms", "result", "files", "job"}`: `result` is JSON, and every result file comes back in `files` as `{"name", "size", "content_type", "kind", "url", "ref"}`. Download it from `url`, or pass `ref` as the input of another file tool.
- A job still running when the wait ends answers 202 with `job`. Follow it with `GET https://setget.net/v1/jobs/<id>?wait=30`, or stream progress from `GET https://setget.net/v1/jobs/<id>/events` (over MCP: the `job` tool). A person can watch it at `job.url`.

## Inputs

- `image` (required, file, a file reference such as `DROP_ID/f1`, accepts image): The image to watermark.
- `text` (required, string): The watermark text, for example a name or a copyright line. Latin, Greek or Cyrillic letters, digits and punctuation.
- `position` (optional, string, one of `top-left`, `top-right`, `bottom-left`, `bottom-right`, `center`, `tile`, default `"bottom-right"`): Where to put it. tile repeats it diagonally across the whole image.
- `opacity` (optional, integer, default `50`, range 1..100): How solid the text is, from 1 (barely visible) to 100 (fully solid).
- `size` (optional, number, default `5`, range 1..50): Height of the text as a percentage of the shorter side of the image.
- `color` (optional, string, default `"#ffffff"`): Colour of the text. A hex colour such as #ff8800, or a name such as white or black.

## Example 1: Bottom-right corner

Upload first. Each placeholder below stands for the reference of one upload: `DROP_ID/f1` = [sample.jpg](https://setget.net/static/samples/sample.jpg).

```json
{"input":{"image":"DROP_ID/f1","text":"(c) Example Studio"},"wait":30}
```

## Example 2: Tiled across the image

Upload first. Each placeholder below stands for the reference of one upload: `DROP_ID/f1` = [sample.jpg](https://setget.net/static/samples/sample.jpg).

```json
{"input":{"image":"DROP_ID/f1","text":"DRAFT","position":"tile","opacity":25,"size":8,"color":"#000000"},"wait":30}
```

**Why is the size relative?** So the watermark looks the same on a small preview and a large original. 5 means the letters are about 5% of the shorter side tall.

**Can a watermark be removed?** A small corner mark can be cropped off. A tiled watermark across the image is much harder to remove.

**Which characters can I use?** Latin letters including accents, Greek, Cyrillic, digits, punctuation and symbols such as the copyright sign. Chinese, Japanese, Korean, Arabic and emoji are not supported yet.

**What if the text is too long?** It is made smaller until it fits inside the image; the result reports the text height used.
