Name: watermark
Price: 0.02 USDC
Availability: InStock

$ man watermark

agentutility / mediakit / watermark

PRICE / CALL

$0.02

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

mediakit

CATEGORY

media

STATUS

● live

NAME

watermark — pdf / image / video watermarking — text or image overlay

SYNOPSIS

POST https://x402.org/v1/watermark
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

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

DESCRIPTION

PDF / image / video watermarking — text or image overlay. CloudConvert engine. Configurable position, opacity, font, rotation, margin. Works on PDFs, PNG/JPG/GIF, MP4/MOV/WEBM.

INPUT — request schema

property	type	description	req?
file_url	string	Public URL of the input file (PDF, PNG, JPG, GIF, BMP, TIFF, WEBP, MP4, MOV, WEBM, MKV, AVI, etc.). The URL extension is used to detect format.	required
text	string	Watermark text. Provide either text OR image_url (not both).	optional
image_url	string	Public URL of an image to use as the watermark (use a transparent PNG).	optional
font_size	number	Font size in points (text watermark). Default 40. Range 6-400.	optional
font_color	string	Font color as 6-digit hex (e.g. '#FF0000'). Default '#000000'.	optional
opacity	number	Opacity 0-100. 100 = fully visible.	optional
rotation	number	Rotation in degrees (-360 to 360).	optional
position_vertical	string	'top', 'center' (default), or 'bottom'. enum: top · center · bottom	optional
position_horizontal	string	'left', 'center' (default), or 'right'. enum: left · center · right	optional

OUTPUT — response shape

field	type	description
output_url	string	Signed CloudConvert URL of the watermarked file (24h expiry).
file_size_bytes	number	Output file size in bytes.
input_format	string	Detected input format (pdf, png, mp4, etc.).
watermark_type	string	'text' or 'image'.
source_url	string	Echo of the input URL.
job_id	string	CloudConvert job id.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

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

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

EXAMPLE 2 · mcp

# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the watermark tool to ..."

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

METADATA

tags: watermarkpdfimagevideobranding
env: CLOUD_CONVERT_API_KEY
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	CSV to JSON / CSV to JSONL converter / data pipeline preprocessor.	$0.02
image-translate	Image translator: vision-OCR + Venice translate.	$0.02
image-upscale	Image upscale / 2x upscaler / 4x upscaler / super-resolution / sharpen image / enlarge image without loss.	$0.02
pdf-watermark	PDF watermark / image watermark / video watermark — text or image overlay on PDFs, PNG/JPG/GIF, or MP4/MOV/WEBM.	$0.02
video-to-subtitles	SRT / VTT subtitle generator from video or audio.	$0.02
video-trim	Video trimmer / video cutter / video clip tool.	$0.02
watermark-pdf	Add watermark to PDF.	$0.02

/watermark(1)