# x402 Image Tools – Watermark / Text Overlay

> x402 Image Tools – Watermark / Text Overlay is a paid API for AI agents from 7fg5bxb40m3f0v23.68r.lambda-web.us-east-1.on.aws, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-29).

Draws a line of text over an image at a specified position, size, color, and opacity, returning a new image with the watermark applied.

## Facts

- Endpoint: POST https://7fg5bxb40m3f0v23.68r.lambda-web.us-east-1.on.aws/v1/watermark?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-image-tools-watermark-text-overlay-ce0db832
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5gyRR5VIwuvWk0Fow_T7b

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402-image-tools-watermark-text-overlay-ce0db832 -d '<json body>'
```

Example prompt: Add the text '© 2025 Acme Corp' as a white watermark at the bottom-right corner of this image https://example.com/photo.jpg, using 5% font size and 0.6 opacity, and return it as a WebP.

## When to prefer this

Choose this endpoint when you need to programmatically add a text watermark or annotation to an existing image at a specific position with configurable styling (color, opacity, size). It is the right choice for copyright stamping, branding overlays, caption placement, or confidentiality labels on photos or document screenshots. Prefer it over general image editing pipelines when the only transformation needed is text overlay.

## Known failure modes

- Image URL unreachable or not a supported format (JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG) returns an error
- Image exceeds 20 MB or 40 megapixel limit
- Text longer than 100 characters rejected
- Font size outside 1–20% range rejected
- Opacity outside 0.05–1 range rejected
- Non-hex color value causes a validation error
- Payment of 0.003 USDC not received causes 402 Payment Required
- Result URL expires after 3600 seconds

## How this service works

Draw a line of text over an image at a corner, an edge or the center, with a size relative to the image width, a color and an opacity.

## Output

A JSON object containing a CDN URL to the watermarked image (valid for ~1 hour), output format, width, height, file size in bytes, input file size, and optionally a data URL of the image if it is under 1 MB and inline was requested.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "https URL of a JPEG, PNG, WebP, AVIF, GIF, TIFF or SVG image (up to 20 MB, 40 megapixels)"
  },
  "size": {
   "type": "number",
   "description": "font size in percent of the image width (1-20, default 4)"
  },
  "text": {
   "type": "string",
   "description": "the text (up to 100 characters; Latin, Greek, Cyrillic and common symbols)"
  },
  "color": {
   "type": "string",
   "description": "hex color (default #ffffff)"
  },
  "format": {
   "enum": [
    "webp",
    "avif",
    "png",
    "jpeg",
    "gif",
    "tiff"
   ],
   "type": "string",
   "description": "output format (default: the input's)"
  },
  "inline": {
   "type": "boolean",
   "description": "also return the image as a data URL when it is at most 1 MB"
  },
  "opacity": {
   "type": "number",
   "description": "0.05-1 (default 0.5)"
  },
  "position": {
   "enum": [
    "top-left",
    "top",
    "top-right",
    "left",
    "center",
    "right",
    "bottom-left",
    "bottom",
    "bottom-right"
   ],
   "type": "string",
   "description": "where (default bottom-right)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://dn8i8p8knpn68.cloudfront.net/results/images/3f1c2b9e.webp?Expires=...",
  "bytes": 48213,
  "width": 800,
  "format": "webp",
  "height": 600,
  "expires_in": 3600,
  "input_bytes": 912345
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-image-tools-watermark-text-overlay-ce0db832/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 7fg5bxb40m3f0v23.68r.lambda-web.us-east-1.on.aws](https://www.zero.xyz/host/7fg5bxb40m3f0v23.68r.lambda-web.us-east-1.on.aws/llms.txt)