Name: add-watermark
Price: 0.02 USDC
Availability: InStock

$ man add-watermark

agentutility / mediakit / add-watermark

PRICE / CALL

$0.02

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

mediakit

CATEGORY

uncategorized

STATUS

● live

NAME

add-watermark — add watermark to pdf, image, or video

synonym alias of watermark — reuses the canonical handler.

SYNOPSIS

POST https://x402.agentutility.ai/add-watermark
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Add watermark to PDF, image, or video. Applies text or image overlays with configurable position, opacity, font, rotation, and margin. CloudConvert backend for PDFs, PNG/JPG/GIF, and MP4/MOV/WEBM.

INPUT — request schema

property	type	description	req?
file_url	string	—	required
text	string	—	optional
image_url	string	—	optional
font_size	number	—	optional
font_color	string	—	optional
opacity	number	—	optional
rotation	number	—	optional
position_vertical	string	— enum: top · center · bottom	optional
position_horizontal	string	— enum: left · center · right	optional

OUTPUT — response shape

field	type	description
output_url	string	—
watermark_type	string	—
input_format	string	—

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/add-watermark \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the add-watermark tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: mediakitaddwatermarkadd-watermark
methods: POST
cluster: mediakit
price: $0.02 USDC per call

ADJACENT — other endpoints in mediakit

endpoint	description	price
audio-loudnorm	Audio loudness normalizer (EBU R128 LUFS).	$0.02
csv-to-jsonl	Converts CSV or TSV data into JSON, JSONL/NDJSON, or column-oriented arrays.	$0.02
image-translate	Image translator.	$0.02
image-upscale	Upscales an image 2x or 4x via Venice's image/upscale endpoint (default model: venice-sd35).	$0.02
image-watermark	Image watermark / add text or logo watermark to image files.	$0.02
mp4-to-mp3	Converts MP4, MOV, WebM, MKV, AVI, M4V, and FLV video files to MP3 via CloudConvert, with selectable bitrate (96/128/192 kbps).	$0.02
mp4-to-mp3-api	Converts MP4, MOV, WEBM, MKV, AVI, M4V, or FLV URLs into hosted MP3 output with selectable 96, 128, or 192 kbps bitrate.	$0.02
mp4-to-mp3-converter	Converts MP4 video URLs into hosted MP3 files with selectable bitrate; also accepts MOV, WEBM, MKV, AVI, M4V, or FLV URLs.	$0.02